Integration Guides
Customer
Payout (off-ramp)
Payin (on-ramp)
Webhook
Widget
cURL
curl --request POST \
--url https://sandbox.dollarpe.xyz/pis/api/v1/payin/initiate \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--header 'X-SIGNATURE: <api-key>' \
--header 'X-TIMESTAMP: <api-key>' \
--data '
{
"quotation_id": "2e104290-07c8-49f1-a5ca-0d27f0078f8a",
"customer_id": "def8b740-99f9-4cba-bc9e-99de57e927b4",
"utr": "RATN0329SJDH0",
"client_reference_id": "testUser123"
}
'{
"status": true,
"message": "Success",
"data": {
"id": "5b75096f-de8d-44b4-9230-d94e6948abb6",
"quotation_id": "2e104290-07c8-49f1-a5ca-0d27f0078f8a",
"customer_id": "def8b740-99f9-4cba-bc9e-99de57e927b4",
"client_reference_id": "testUser123",
"bank_id": "e75f62f0-db9e-4904-8103-d6f14f67f5dc",
"asset": "USDT",
"fiat": "INR",
"payment_method": "IMPS",
"rate": 82.5,
"sending_amount": 51,
"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
},
"deposit_instructions": {
"account_number": "1234567890",
"ifsc": "1234567890",
"account_name": "Sandbox Technologies Pvt Ltd"
},
"utr": "RATN0329SJDH0",
"created_at": "2025-03-08T07:31:24.770179Z",
"status": "PROCESSING"
}
}Payin Order
Create Payin
Create a new payin using a quotation
POST
/
payin
/
initiate
cURL
curl --request POST \
--url https://sandbox.dollarpe.xyz/pis/api/v1/payin/initiate \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--header 'X-SIGNATURE: <api-key>' \
--header 'X-TIMESTAMP: <api-key>' \
--data '
{
"quotation_id": "2e104290-07c8-49f1-a5ca-0d27f0078f8a",
"customer_id": "def8b740-99f9-4cba-bc9e-99de57e927b4",
"utr": "RATN0329SJDH0",
"client_reference_id": "testUser123"
}
'{
"status": true,
"message": "Success",
"data": {
"id": "5b75096f-de8d-44b4-9230-d94e6948abb6",
"quotation_id": "2e104290-07c8-49f1-a5ca-0d27f0078f8a",
"customer_id": "def8b740-99f9-4cba-bc9e-99de57e927b4",
"client_reference_id": "testUser123",
"bank_id": "e75f62f0-db9e-4904-8103-d6f14f67f5dc",
"asset": "USDT",
"fiat": "INR",
"payment_method": "IMPS",
"rate": 82.5,
"sending_amount": 51,
"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
},
"deposit_instructions": {
"account_number": "1234567890",
"ifsc": "1234567890",
"account_name": "Sandbox Technologies Pvt Ltd"
},
"utr": "RATN0329SJDH0",
"created_at": "2025-03-08T07:31:24.770179Z",
"status": "PROCESSING"
}
}Error Codes and Messages
| API Status Code | Response | Reason |
|---|---|---|
| 400 | UTR is already linked to another payin | UTR already linked to another payin |
| 400 | Client Reference ID already exists | Client Reference ID already exists |
| 400 | Invalid UTR format | UTR length is not equal to 12 characters |
| 400 | Quotation is not found | Quotation does not exist or does not belong to this organization |
| 400 | Customer ID does not match with the quotation | Customer ID mismatch between payin order and quotation |
| 400 | Quotation has expired | Quotation has expired |
| 400 | Quotation is already linked to another payin | Quotation is already linked to another payin |
| 500 | Internal Server Error | Internal Server Error |
Authorizations
API Key for authentication
Current timestamp in seconds since epoch
HMAC SHA256 signature of the request encoded in Base64
Body
application/json
The unique identifier of the quotation
Example:
"2e104290-07c8-49f1-a5ca-0d27f0078f8a"
The unique identifier of the customer
Example:
"def8b740-99f9-4cba-bc9e-99de57e927b4"
UTR of the bank transaction
Example:
"RATN0329SJDH0"
Optional client reference ID for tracking
Example:
"testUser123"
⌘I