curl --request POST \
--url https://api.sandbox.paywint.com/api/user-api/payment/create-payment-link \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <x-api-key>' \
--header 'X-Api-Secret: <x-api-secret>' \
--data '
{
"amount": 150.75,
"description": "Payment for June invoice",
"invoice_number": "INV-2025-0012"
}
'import requests
url = "https://api.sandbox.paywint.com/api/user-api/payment/create-payment-link"
payload = {
"amount": 150.75,
"description": "Payment for June invoice",
"invoice_number": "INV-2025-0012"
}
headers = {
"X-Api-Key": "<x-api-key>",
"X-Api-Secret": "<x-api-secret>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Api-Key': '<x-api-key>',
'X-Api-Secret': '<x-api-secret>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
amount: 150.75,
description: 'Payment for June invoice',
invoice_number: 'INV-2025-0012'
})
};
fetch('https://api.sandbox.paywint.com/api/user-api/payment/create-payment-link', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sandbox.paywint.com/api/user-api/payment/create-payment-link",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'amount' => 150.75,
'description' => 'Payment for June invoice',
'invoice_number' => 'INV-2025-0012'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Api-Key: <x-api-key>",
"X-Api-Secret: <x-api-secret>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.sandbox.paywint.com/api/user-api/payment/create-payment-link"
payload := strings.NewReader("{\n \"amount\": 150.75,\n \"description\": \"Payment for June invoice\",\n \"invoice_number\": \"INV-2025-0012\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<x-api-key>")
req.Header.Add("X-Api-Secret", "<x-api-secret>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.sandbox.paywint.com/api/user-api/payment/create-payment-link")
.header("X-Api-Key", "<x-api-key>")
.header("X-Api-Secret", "<x-api-secret>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 150.75,\n \"description\": \"Payment for June invoice\",\n \"invoice_number\": \"INV-2025-0012\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.paywint.com/api/user-api/payment/create-payment-link")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<x-api-key>'
request["X-Api-Secret"] = '<x-api-secret>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amount\": 150.75,\n \"description\": \"Payment for June invoice\",\n \"invoice_number\": \"INV-2025-0012\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Operation completed.",
"data": {
"payment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"payment_link": "<string>"
},
"queryGeneratedTime": 1718006400
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Create Payment Link
Generates a secure payment link to collect wallet-based payments from customers or external users.
This endpoint:
- Creates a new pending payment request for the user
- Provides a shareable URL that can be sent to others for payment collection
- Returns the generated payment ID and link
curl --request POST \
--url https://api.sandbox.paywint.com/api/user-api/payment/create-payment-link \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <x-api-key>' \
--header 'X-Api-Secret: <x-api-secret>' \
--data '
{
"amount": 150.75,
"description": "Payment for June invoice",
"invoice_number": "INV-2025-0012"
}
'import requests
url = "https://api.sandbox.paywint.com/api/user-api/payment/create-payment-link"
payload = {
"amount": 150.75,
"description": "Payment for June invoice",
"invoice_number": "INV-2025-0012"
}
headers = {
"X-Api-Key": "<x-api-key>",
"X-Api-Secret": "<x-api-secret>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Api-Key': '<x-api-key>',
'X-Api-Secret': '<x-api-secret>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
amount: 150.75,
description: 'Payment for June invoice',
invoice_number: 'INV-2025-0012'
})
};
fetch('https://api.sandbox.paywint.com/api/user-api/payment/create-payment-link', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sandbox.paywint.com/api/user-api/payment/create-payment-link",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'amount' => 150.75,
'description' => 'Payment for June invoice',
'invoice_number' => 'INV-2025-0012'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Api-Key: <x-api-key>",
"X-Api-Secret: <x-api-secret>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.sandbox.paywint.com/api/user-api/payment/create-payment-link"
payload := strings.NewReader("{\n \"amount\": 150.75,\n \"description\": \"Payment for June invoice\",\n \"invoice_number\": \"INV-2025-0012\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<x-api-key>")
req.Header.Add("X-Api-Secret", "<x-api-secret>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.sandbox.paywint.com/api/user-api/payment/create-payment-link")
.header("X-Api-Key", "<x-api-key>")
.header("X-Api-Secret", "<x-api-secret>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 150.75,\n \"description\": \"Payment for June invoice\",\n \"invoice_number\": \"INV-2025-0012\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.paywint.com/api/user-api/payment/create-payment-link")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<x-api-key>'
request["X-Api-Secret"] = '<x-api-secret>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amount\": 150.75,\n \"description\": \"Payment for June invoice\",\n \"invoice_number\": \"INV-2025-0012\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Operation completed.",
"data": {
"payment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"payment_link": "<string>"
},
"queryGeneratedTime": 1718006400
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Headers
Your API Key (UUID format). Required to identify and authorize each request
Secret associated with your API Key. Used for authenticating requests. Keep this secure.
Body
Amount to be collected via the payment link.
150.75
Optional note or context about the payment (e.g., product name, service details).
255"Payment for June invoice"
Optional invoice reference tied to this payment request.
20"INV-2025-0012"
Response
Successful Response
Indicates whether the request was processed successfully.
true
A short, human-readable message describing the result of the request.
"Operation completed."
The main response payload, if applicable
Show child attributes
Show child attributes
The Unix timestamp (in seconds) indicating when the response was generated.
1718006400
