curl --request POST \
--url https://api.paywint.com/api/platform/cross-border/payee/bank/{user_id} \
--header 'Content-Type: application/json' \
--header 'X-Platform-ID: <x-platform-id>' \
--header 'X-Signature: <x-signature>' \
--data '
{
"payee_id": "f47ac10b-****-****-****-0e02b2c3d479",
"bank_nick_name": "HDFC savings",
"account_number": "<string>",
"country": "IN",
"bank_acc_type": "savings",
"identifier_value": "SBIN0000123",
"payout_bank_id": "921874"
}
'import requests
url = "https://api.paywint.com/api/platform/cross-border/payee/bank/{user_id}"
payload = {
"payee_id": "f47ac10b-****-****-****-0e02b2c3d479",
"bank_nick_name": "HDFC savings",
"account_number": "<string>",
"country": "IN",
"bank_acc_type": "savings",
"identifier_value": "SBIN0000123",
"payout_bank_id": "921874"
}
headers = {
"X-Platform-ID": "<x-platform-id>",
"X-Signature": "<x-signature>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Platform-ID': '<x-platform-id>',
'X-Signature': '<x-signature>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
payee_id: 'f47ac10b-****-****-****-0e02b2c3d479',
bank_nick_name: 'HDFC savings',
account_number: '<string>',
country: 'IN',
bank_acc_type: 'savings',
identifier_value: 'SBIN0000123',
payout_bank_id: '921874'
})
};
fetch('https://api.paywint.com/api/platform/cross-border/payee/bank/{user_id}', 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.paywint.com/api/platform/cross-border/payee/bank/{user_id}",
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([
'payee_id' => 'f47ac10b-****-****-****-0e02b2c3d479',
'bank_nick_name' => 'HDFC savings',
'account_number' => '<string>',
'country' => 'IN',
'bank_acc_type' => 'savings',
'identifier_value' => 'SBIN0000123',
'payout_bank_id' => '921874'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Platform-ID: <x-platform-id>",
"X-Signature: <x-signature>"
],
]);
$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.paywint.com/api/platform/cross-border/payee/bank/{user_id}"
payload := strings.NewReader("{\n \"payee_id\": \"f47ac10b-****-****-****-0e02b2c3d479\",\n \"bank_nick_name\": \"HDFC savings\",\n \"account_number\": \"<string>\",\n \"country\": \"IN\",\n \"bank_acc_type\": \"savings\",\n \"identifier_value\": \"SBIN0000123\",\n \"payout_bank_id\": \"921874\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Platform-ID", "<x-platform-id>")
req.Header.Add("X-Signature", "<x-signature>")
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.paywint.com/api/platform/cross-border/payee/bank/{user_id}")
.header("X-Platform-ID", "<x-platform-id>")
.header("X-Signature", "<x-signature>")
.header("Content-Type", "application/json")
.body("{\n \"payee_id\": \"f47ac10b-****-****-****-0e02b2c3d479\",\n \"bank_nick_name\": \"HDFC savings\",\n \"account_number\": \"<string>\",\n \"country\": \"IN\",\n \"bank_acc_type\": \"savings\",\n \"identifier_value\": \"SBIN0000123\",\n \"payout_bank_id\": \"921874\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.paywint.com/api/platform/cross-border/payee/bank/{user_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Platform-ID"] = '<x-platform-id>'
request["X-Signature"] = '<x-signature>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"payee_id\": \"f47ac10b-****-****-****-0e02b2c3d479\",\n \"bank_nick_name\": \"HDFC savings\",\n \"account_number\": \"<string>\",\n \"country\": \"IN\",\n \"bank_acc_type\": \"savings\",\n \"identifier_value\": \"SBIN0000123\",\n \"payout_bank_id\": \"921874\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Operation completed.",
"data": {
"bank_id": "2d8c5ca1-98cb-42f7-8c1e-70a2b0b8e8f1",
"account_number": "1234567890",
"country": "IN",
"bank_acc_type": "savings",
"created_at": "2023-11-07T05:31:56Z",
"bank_nick_name": "<string>",
"bank_identifier_type": "IFSC",
"bank_identifier_value": "SBIN0000123",
"updated_at": "2023-11-07T05:31:56Z"
},
"queryGeneratedTime": 1718006400
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Add a Payee Bank
Adds a cross-border bank account for a payee.
Identify the payee by payee_id. Send the bank details — account_number, country (ISO2),
bank_acc_type, identifier_type, identifier_value, an optional bank_nick_name and an optional
payout_bank_id. Each field only accepts values within the maximum length allowed by the payee rules
for the destination country — see GET /cross-border/payee-rules. Returns the created cross-border bank.
curl --request POST \
--url https://api.paywint.com/api/platform/cross-border/payee/bank/{user_id} \
--header 'Content-Type: application/json' \
--header 'X-Platform-ID: <x-platform-id>' \
--header 'X-Signature: <x-signature>' \
--data '
{
"payee_id": "f47ac10b-****-****-****-0e02b2c3d479",
"bank_nick_name": "HDFC savings",
"account_number": "<string>",
"country": "IN",
"bank_acc_type": "savings",
"identifier_value": "SBIN0000123",
"payout_bank_id": "921874"
}
'import requests
url = "https://api.paywint.com/api/platform/cross-border/payee/bank/{user_id}"
payload = {
"payee_id": "f47ac10b-****-****-****-0e02b2c3d479",
"bank_nick_name": "HDFC savings",
"account_number": "<string>",
"country": "IN",
"bank_acc_type": "savings",
"identifier_value": "SBIN0000123",
"payout_bank_id": "921874"
}
headers = {
"X-Platform-ID": "<x-platform-id>",
"X-Signature": "<x-signature>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Platform-ID': '<x-platform-id>',
'X-Signature': '<x-signature>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
payee_id: 'f47ac10b-****-****-****-0e02b2c3d479',
bank_nick_name: 'HDFC savings',
account_number: '<string>',
country: 'IN',
bank_acc_type: 'savings',
identifier_value: 'SBIN0000123',
payout_bank_id: '921874'
})
};
fetch('https://api.paywint.com/api/platform/cross-border/payee/bank/{user_id}', 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.paywint.com/api/platform/cross-border/payee/bank/{user_id}",
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([
'payee_id' => 'f47ac10b-****-****-****-0e02b2c3d479',
'bank_nick_name' => 'HDFC savings',
'account_number' => '<string>',
'country' => 'IN',
'bank_acc_type' => 'savings',
'identifier_value' => 'SBIN0000123',
'payout_bank_id' => '921874'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Platform-ID: <x-platform-id>",
"X-Signature: <x-signature>"
],
]);
$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.paywint.com/api/platform/cross-border/payee/bank/{user_id}"
payload := strings.NewReader("{\n \"payee_id\": \"f47ac10b-****-****-****-0e02b2c3d479\",\n \"bank_nick_name\": \"HDFC savings\",\n \"account_number\": \"<string>\",\n \"country\": \"IN\",\n \"bank_acc_type\": \"savings\",\n \"identifier_value\": \"SBIN0000123\",\n \"payout_bank_id\": \"921874\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Platform-ID", "<x-platform-id>")
req.Header.Add("X-Signature", "<x-signature>")
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.paywint.com/api/platform/cross-border/payee/bank/{user_id}")
.header("X-Platform-ID", "<x-platform-id>")
.header("X-Signature", "<x-signature>")
.header("Content-Type", "application/json")
.body("{\n \"payee_id\": \"f47ac10b-****-****-****-0e02b2c3d479\",\n \"bank_nick_name\": \"HDFC savings\",\n \"account_number\": \"<string>\",\n \"country\": \"IN\",\n \"bank_acc_type\": \"savings\",\n \"identifier_value\": \"SBIN0000123\",\n \"payout_bank_id\": \"921874\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.paywint.com/api/platform/cross-border/payee/bank/{user_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Platform-ID"] = '<x-platform-id>'
request["X-Signature"] = '<x-signature>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"payee_id\": \"f47ac10b-****-****-****-0e02b2c3d479\",\n \"bank_nick_name\": \"HDFC savings\",\n \"account_number\": \"<string>\",\n \"country\": \"IN\",\n \"bank_acc_type\": \"savings\",\n \"identifier_value\": \"SBIN0000123\",\n \"payout_bank_id\": \"921874\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Operation completed.",
"data": {
"bank_id": "2d8c5ca1-98cb-42f7-8c1e-70a2b0b8e8f1",
"account_number": "1234567890",
"country": "IN",
"bank_acc_type": "savings",
"created_at": "2023-11-07T05:31:56Z",
"bank_nick_name": "<string>",
"bank_identifier_type": "IFSC",
"bank_identifier_value": "SBIN0000123",
"updated_at": "2023-11-07T05:31:56Z"
},
"queryGeneratedTime": 1718006400
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Headers
Path Parameters
Body
Platform-side add cross-border payee bank request — stores the payee's bank details.
The payer is NOT fixed here: it is supplied at payout time, and the payer's mandatory fields are
fetched from the payer rules and validated on each payout. So this request carries only the core
bank fields plus the owning payee (payee_id).
Response
Successful Response

