Skip to main content
POST
/
payout
/
quotation
cURL
curl --request POST \
  --url https://sandbox.dollarpe.xyz/pos/api/v1/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",
  "sending_amount": "51",
  "customer_id": "def8b740-99f9-4cba-bc9e-99de57e927b4",
  "bank_id": "4e6f1b20-a73c-11ec-b909-0242ac120002",
  "risk_parameters": {
    "ip_address": "127.0.0.1",
    "device_id": "<string>",
    "suspicious_activity_report": false,
    "law_enforcement_agency_report": false
  }
}
'
{
  "status": true,
  "message": "Success",
  "data": {
    "id": "2e104290-07c8-49f1-a5ca-0d27f0078f8a",
    "customer_id": "def8b740-99f9-4cba-bc9e-99de57e927b4",
    "bank_id": "4e6f1b20-a73c-11ec-b909-0242ac120002",
    "asset": "USDT",
    "fiat": "INR",
    "sending_amount": 51,
    "rate": 82.5,
    "receiving_amount": 4144.6,
    "fees": {
      "client_fee_fiat": 450,
      "client_fee_crypto": 5,
      "dollarpe_fee": 450,
      "pg_fee": 18,
      "client_gst_fiat": 81,
      "client_gst_crypto": 0.9,
      "dollarpe_gst": 81,
      "pg_gst": 81,
      "tds": 889.17,
      "gross_effective_exchange_rate": 88.92
    },
    "created_at": "2025-03-08T07:31:11.163005Z",
    "expiry_time": "2025-03-08T07:36:11.163005Z"
  }
}
UPI is not currently supported for payouts.

Error Codes and Messages

API Status CodeResponseReason
400Customer is unverifiedCustomer is added but KYC is unverified
400Customer is unverifiedCustomer does not belong to Organization
400Bank account is unverifiedBank account is not added
400Bank account is unverifiedBank account is added but under processing
400Bank account is unverifiedName mismatch between PAN and Bank account
400Bank account is unverifiedBank account is linked to some other customer
400UPI is not supportedUPI payout is currently not supported
400Entered amount is less than minimum transaction amountEntered amount must be greater than INR 2500
400Entered amount exceeds maximum transaction amountEntered amount must be less than:
• INR 500,000 for IMPS
400AML SCREENING FAILEDCustomer appears in sanction lists and the Politically Exposed Persons (PEP) database and/or has material adverse media
400EDD requiredSuspicious activity or Red Flag Indicator is triggered
400EDD requiredTransaction milestone since last EDD is reached^
400EDD requiredAnnual EDD is due or overdue
400Daily offramp limit exhaustedDaily offramp limit exhausted
500Internal Server ErrorInternal Server Error
503Service unavailableUnexpected Error Occurred

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"

sending_amount
string
required

The amount to be sent

Example:

"51"

customer_id
string<uuid>
required

Customer's unique identifier

Example:

"def8b740-99f9-4cba-bc9e-99de57e927b4"

bank_id
string<uuid>
required

Customer's Bank's unique identifier in which the payout will be maid

Example:

"4e6f1b20-a73c-11ec-b909-0242ac120002"

risk_parameters
object
required

Response

Quotation created successfully

status
boolean
Example:

true

message
string
Example:

"Success"

data
object