Create Quotation

cURL

curl --request POST \
  --url https://sandbox.zapyd.com/pos/api/v1/remittance-payout/quotation \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --header 'X-SIGNATURE: <api-key>' \
  --header 'X-TIMESTAMP: <api-key>' \
  --data '
{
  "asset": "USDT",
  "fiat": "INR",
  "customer_id": "84737c7d-7b62-4204-80d6-80f6ecb3ceb4",
  "bank_id": "cab47575-bbcb-4294-81a3-30774104f3b6",
  "remitter_id": "e14fa86f-2a5e-437a-a031-949c68ade933",
  "risk_parameters": {},
  "payment_method": "IMPS",
  "is_self_transfer": false,
  "network": "tron",
  "sending_amount": "100",
  "receiving_amount": "5100"
}
'

import requests

url = "https://sandbox.zapyd.com/pos/api/v1/remittance-payout/quotation"

payload = {
    "asset": "USDT",
    "fiat": "INR",
    "customer_id": "84737c7d-7b62-4204-80d6-80f6ecb3ceb4",
    "bank_id": "cab47575-bbcb-4294-81a3-30774104f3b6",
    "remitter_id": "e14fa86f-2a5e-437a-a031-949c68ade933",
    "risk_parameters": {},
    "payment_method": "IMPS",
    "is_self_transfer": False,
    "network": "tron",
    "sending_amount": "100",
    "receiving_amount": "5100"
}
headers = {
    "X-API-KEY": "<api-key>",
    "X-TIMESTAMP": "<api-key>",
    "X-SIGNATURE": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-API-KEY': '<api-key>',
    'X-TIMESTAMP': '<api-key>',
    'X-SIGNATURE': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    asset: 'USDT',
    fiat: 'INR',
    customer_id: '84737c7d-7b62-4204-80d6-80f6ecb3ceb4',
    bank_id: 'cab47575-bbcb-4294-81a3-30774104f3b6',
    remitter_id: 'e14fa86f-2a5e-437a-a031-949c68ade933',
    risk_parameters: {},
    payment_method: 'IMPS',
    is_self_transfer: false,
    network: 'tron',
    sending_amount: '100',
    receiving_amount: '5100'
  })
};

fetch('https://sandbox.zapyd.com/pos/api/v1/remittance-payout/quotation', 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://sandbox.zapyd.com/pos/api/v1/remittance-payout/quotation",
  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([
    'asset' => 'USDT',
    'fiat' => 'INR',
    'customer_id' => '84737c7d-7b62-4204-80d6-80f6ecb3ceb4',
    'bank_id' => 'cab47575-bbcb-4294-81a3-30774104f3b6',
    'remitter_id' => 'e14fa86f-2a5e-437a-a031-949c68ade933',
    'risk_parameters' => [
        
    ],
    'payment_method' => 'IMPS',
    'is_self_transfer' => false,
    'network' => 'tron',
    'sending_amount' => '100',
    'receiving_amount' => '5100'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>",
    "X-SIGNATURE: <api-key>",
    "X-TIMESTAMP: <api-key>"
  ],
]);

$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://sandbox.zapyd.com/pos/api/v1/remittance-payout/quotation"

	payload := strings.NewReader("{\n  \"asset\": \"USDT\",\n  \"fiat\": \"INR\",\n  \"customer_id\": \"84737c7d-7b62-4204-80d6-80f6ecb3ceb4\",\n  \"bank_id\": \"cab47575-bbcb-4294-81a3-30774104f3b6\",\n  \"remitter_id\": \"e14fa86f-2a5e-437a-a031-949c68ade933\",\n  \"risk_parameters\": {},\n  \"payment_method\": \"IMPS\",\n  \"is_self_transfer\": false,\n  \"network\": \"tron\",\n  \"sending_amount\": \"100\",\n  \"receiving_amount\": \"5100\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("X-TIMESTAMP", "<api-key>")
	req.Header.Add("X-SIGNATURE", "<api-key>")
	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://sandbox.zapyd.com/pos/api/v1/remittance-payout/quotation")
  .header("X-API-KEY", "<api-key>")
  .header("X-TIMESTAMP", "<api-key>")
  .header("X-SIGNATURE", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"asset\": \"USDT\",\n  \"fiat\": \"INR\",\n  \"customer_id\": \"84737c7d-7b62-4204-80d6-80f6ecb3ceb4\",\n  \"bank_id\": \"cab47575-bbcb-4294-81a3-30774104f3b6\",\n  \"remitter_id\": \"e14fa86f-2a5e-437a-a031-949c68ade933\",\n  \"risk_parameters\": {},\n  \"payment_method\": \"IMPS\",\n  \"is_self_transfer\": false,\n  \"network\": \"tron\",\n  \"sending_amount\": \"100\",\n  \"receiving_amount\": \"5100\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://sandbox.zapyd.com/pos/api/v1/remittance-payout/quotation")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["X-TIMESTAMP"] = '<api-key>'
request["X-SIGNATURE"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"asset\": \"USDT\",\n  \"fiat\": \"INR\",\n  \"customer_id\": \"84737c7d-7b62-4204-80d6-80f6ecb3ceb4\",\n  \"bank_id\": \"cab47575-bbcb-4294-81a3-30774104f3b6\",\n  \"remitter_id\": \"e14fa86f-2a5e-437a-a031-949c68ade933\",\n  \"risk_parameters\": {},\n  \"payment_method\": \"IMPS\",\n  \"is_self_transfer\": false,\n  \"network\": \"tron\",\n  \"sending_amount\": \"100\",\n  \"receiving_amount\": \"5100\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": true,
  "message": "Success",
  "data": {
    "id": "59bf60c3-e9af-40a7-9d5c-2a1aa191e769",
    "customer_id": "84737c7d-7b62-4204-80d6-80f6ecb3ceb4",
    "bank_id": "cab47575-bbcb-4294-81a3-30774104f3b6",
    "remitter_id": "e14fa86f-2a5e-437a-a031-949c68ade933",
    "asset": "USDT",
    "fiat": "INR",
    "network": "tron",
    "sending_amount": "60.00",
    "rate": "85.00",
    "receiving_amount": "5100.00",
    "fees": {
      "zapyd_fee": "0.00",
      "client_fee": "0.00",
      "client_gst": "0.00",
      "tds": "0"
    },
    "wallet_address": "TXqH4MnDw46f3yyrRwau3JF92Y1ie3pAXf",
    "created_at": "2026-09-30T10:00:00Z",
    "expiry_time": "2026-09-30T10:10:00Z"
  }
}

{
  "status": false,
  "message": "Bad Request",
  "error": {
    "remitter_id": [
      "This field is required."
    ]
  }
}

{
  "status": false,
  "message": "Internal Server Error"
}

POST

remittance-payout

quotation

cURL

curl --request POST \
  --url https://sandbox.zapyd.com/pos/api/v1/remittance-payout/quotation \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --header 'X-SIGNATURE: <api-key>' \
  --header 'X-TIMESTAMP: <api-key>' \
  --data '
{
  "asset": "USDT",
  "fiat": "INR",
  "customer_id": "84737c7d-7b62-4204-80d6-80f6ecb3ceb4",
  "bank_id": "cab47575-bbcb-4294-81a3-30774104f3b6",
  "remitter_id": "e14fa86f-2a5e-437a-a031-949c68ade933",
  "risk_parameters": {},
  "payment_method": "IMPS",
  "is_self_transfer": false,
  "network": "tron",
  "sending_amount": "100",
  "receiving_amount": "5100"
}
'

import requests

url = "https://sandbox.zapyd.com/pos/api/v1/remittance-payout/quotation"

payload = {
    "asset": "USDT",
    "fiat": "INR",
    "customer_id": "84737c7d-7b62-4204-80d6-80f6ecb3ceb4",
    "bank_id": "cab47575-bbcb-4294-81a3-30774104f3b6",
    "remitter_id": "e14fa86f-2a5e-437a-a031-949c68ade933",
    "risk_parameters": {},
    "payment_method": "IMPS",
    "is_self_transfer": False,
    "network": "tron",
    "sending_amount": "100",
    "receiving_amount": "5100"
}
headers = {
    "X-API-KEY": "<api-key>",
    "X-TIMESTAMP": "<api-key>",
    "X-SIGNATURE": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-API-KEY': '<api-key>',
    'X-TIMESTAMP': '<api-key>',
    'X-SIGNATURE': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    asset: 'USDT',
    fiat: 'INR',
    customer_id: '84737c7d-7b62-4204-80d6-80f6ecb3ceb4',
    bank_id: 'cab47575-bbcb-4294-81a3-30774104f3b6',
    remitter_id: 'e14fa86f-2a5e-437a-a031-949c68ade933',
    risk_parameters: {},
    payment_method: 'IMPS',
    is_self_transfer: false,
    network: 'tron',
    sending_amount: '100',
    receiving_amount: '5100'
  })
};

fetch('https://sandbox.zapyd.com/pos/api/v1/remittance-payout/quotation', 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://sandbox.zapyd.com/pos/api/v1/remittance-payout/quotation",
  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([
    'asset' => 'USDT',
    'fiat' => 'INR',
    'customer_id' => '84737c7d-7b62-4204-80d6-80f6ecb3ceb4',
    'bank_id' => 'cab47575-bbcb-4294-81a3-30774104f3b6',
    'remitter_id' => 'e14fa86f-2a5e-437a-a031-949c68ade933',
    'risk_parameters' => [
        
    ],
    'payment_method' => 'IMPS',
    'is_self_transfer' => false,
    'network' => 'tron',
    'sending_amount' => '100',
    'receiving_amount' => '5100'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>",
    "X-SIGNATURE: <api-key>",
    "X-TIMESTAMP: <api-key>"
  ],
]);

$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://sandbox.zapyd.com/pos/api/v1/remittance-payout/quotation"

	payload := strings.NewReader("{\n  \"asset\": \"USDT\",\n  \"fiat\": \"INR\",\n  \"customer_id\": \"84737c7d-7b62-4204-80d6-80f6ecb3ceb4\",\n  \"bank_id\": \"cab47575-bbcb-4294-81a3-30774104f3b6\",\n  \"remitter_id\": \"e14fa86f-2a5e-437a-a031-949c68ade933\",\n  \"risk_parameters\": {},\n  \"payment_method\": \"IMPS\",\n  \"is_self_transfer\": false,\n  \"network\": \"tron\",\n  \"sending_amount\": \"100\",\n  \"receiving_amount\": \"5100\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("X-TIMESTAMP", "<api-key>")
	req.Header.Add("X-SIGNATURE", "<api-key>")
	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://sandbox.zapyd.com/pos/api/v1/remittance-payout/quotation")
  .header("X-API-KEY", "<api-key>")
  .header("X-TIMESTAMP", "<api-key>")
  .header("X-SIGNATURE", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"asset\": \"USDT\",\n  \"fiat\": \"INR\",\n  \"customer_id\": \"84737c7d-7b62-4204-80d6-80f6ecb3ceb4\",\n  \"bank_id\": \"cab47575-bbcb-4294-81a3-30774104f3b6\",\n  \"remitter_id\": \"e14fa86f-2a5e-437a-a031-949c68ade933\",\n  \"risk_parameters\": {},\n  \"payment_method\": \"IMPS\",\n  \"is_self_transfer\": false,\n  \"network\": \"tron\",\n  \"sending_amount\": \"100\",\n  \"receiving_amount\": \"5100\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://sandbox.zapyd.com/pos/api/v1/remittance-payout/quotation")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["X-TIMESTAMP"] = '<api-key>'
request["X-SIGNATURE"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"asset\": \"USDT\",\n  \"fiat\": \"INR\",\n  \"customer_id\": \"84737c7d-7b62-4204-80d6-80f6ecb3ceb4\",\n  \"bank_id\": \"cab47575-bbcb-4294-81a3-30774104f3b6\",\n  \"remitter_id\": \"e14fa86f-2a5e-437a-a031-949c68ade933\",\n  \"risk_parameters\": {},\n  \"payment_method\": \"IMPS\",\n  \"is_self_transfer\": false,\n  \"network\": \"tron\",\n  \"sending_amount\": \"100\",\n  \"receiving_amount\": \"5100\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": true,
  "message": "Success",
  "data": {
    "id": "59bf60c3-e9af-40a7-9d5c-2a1aa191e769",
    "customer_id": "84737c7d-7b62-4204-80d6-80f6ecb3ceb4",
    "bank_id": "cab47575-bbcb-4294-81a3-30774104f3b6",
    "remitter_id": "e14fa86f-2a5e-437a-a031-949c68ade933",
    "asset": "USDT",
    "fiat": "INR",
    "network": "tron",
    "sending_amount": "60.00",
    "rate": "85.00",
    "receiving_amount": "5100.00",
    "fees": {
      "zapyd_fee": "0.00",
      "client_fee": "0.00",
      "client_gst": "0.00",
      "tds": "0"
    },
    "wallet_address": "TXqH4MnDw46f3yyrRwau3JF92Y1ie3pAXf",
    "created_at": "2026-09-30T10:00:00Z",
    "expiry_time": "2026-09-30T10:10:00Z"
  }
}

{
  "status": false,
  "message": "Bad Request",
  "error": {
    "remitter_id": [
      "This field is required."
    ]
  }
}

{
  "status": false,
  "message": "Internal Server Error"
}

Create Quotation

Open in Cursor

Send exactly one amount. receiving_amount fixes the fiat the beneficiary gets, and the response’s sending_amount is the crypto needed. sending_amount fixes the crypto you send, and the response’s receiving_amount is what the beneficiary gets.

remitter_id is required — create the remitter first via Create Remitter.

Error Codes and Messages

API Status Code	Response	Reason
400	Bad Request	A required field (e.g. `remitter_id`) is missing
400	Customer is unverified	Customer KYC is unverified or does not belong to Organization
400	Bank account is unverified	Bank account is not added or still under processing
500	Internal Server Error	Internal Server Error

Authorizations

X-API-KEY

string

header

required

API Key for authentication

X-TIMESTAMP

string

header

required

Current timestamp in seconds since epoch

X-SIGNATURE

string

header

required

HMAC SHA256 signature of the request encoded in Base64

Body

application/json

asset

string

required

The cryptocurrency asset code

Example:

"USDT"

fiat

string

required

The fiat currency code

Example:

"INR"

customer_id

string<uuid>

required

The unique identifier of the receiving customer

Example:

"84737c7d-7b62-4204-80d6-80f6ecb3ceb4"

bank_id

string<uuid>

required

The unique identifier of the customer's bank account in which the payout will be made

Example:

"cab47575-bbcb-4294-81a3-30774104f3b6"

remitter_id

string<uuid>

required

The unique identifier of the remitter (sending party), obtained from POST /kyc/remitter/create

Example:

"e14fa86f-2a5e-437a-a031-949c68ade933"

risk_parameters

object

required

Required. Send every key listed in required_risk_parameters for the fiat in Fetch Configuration. Send {} if that list is empty.

Example:

{}

payment_method

string

required

Payout payment method, valid for the fiat (see Fetch Configuration).

Example:

"IMPS"

is_self_transfer

boolean

required

True when the remitter is sending to their own account.

Example:

false

network

string

required

Blockchain network, for example tron. On the prefunded model it must match your prefunded wallet network.

Example:

"tron"

sending_amount

string

Crypto amount you will send. Send this or receiving_amount, not both.

Example:

"100"

receiving_amount

string

Fiat amount the beneficiary should receive. Send this or sending_amount, not both.

Example:

"5100"

Response

Remittance quotation created successfully

status

boolean

Example:

true

message

string

Example:

"Success"

data

object

Hide child attributes

data.id

string<uuid>

Quotation ID

Example:

"59bf60c3-e9af-40a7-9d5c-2a1aa191e769"

data.customer_id

string<uuid>

Customer ID

Example:

"84737c7d-7b62-4204-80d6-80f6ecb3ceb4"

data.bank_id

string<uuid>

Bank account ID

Example:

"cab47575-bbcb-4294-81a3-30774104f3b6"

data.remitter_id

string<uuid>

Remitter ID (remittance quotations only)

Example:

"e14fa86f-2a5e-437a-a031-949c68ade933"

data.asset

string

Crypto asset

Example:

"USDT"

data.fiat

string

Fiat currency

Example:

"INR"

data.network

string

Network

Example:

"tron"

data.sending_amount

string

Crypto amount to send

Example:

"60.00"

data.rate

string

Fee-inclusive rate

Example:

"85.00"

data.receiving_amount

string

Fiat amount the beneficiary receives

Example:

"5100.00"

data.fees

object

Fee breakdown

Example:

{
  "zapyd_fee": "0.00",
  "client_fee": "0.00",
  "client_gst": "0.00",
  "tds": "0"
}

data.wallet_address

string

Deposit address: send the crypto here

Example:

"TXqH4MnDw46f3yyrRwau3JF92Y1ie3pAXf"

data.created_at

string<date-time>

Example:

"2026-09-30T10:00:00Z"

data.expiry_time

string<date-time>

Quotation expiry

Example:

"2026-09-30T10:10:00Z"

Using the API

Onboarding

Money movement

Platform

Sandbox

Create Quotation

Error Codes and Messages

Authorizations

Body

Response

​Error Codes and Messages

Authorizations

Body

Response

Error Codes and Messages