Skip to main content
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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.dollarpe.xyz/llms.txt

Use this file to discover all available pages before exploring further.

​
Error Codes and Messages

API Status CodeResponseReason
400UTR is already linked to another payinUTR already linked to another payin
400Client Reference ID already existsClient Reference ID already exists
400Invalid UTR formatUTR length is not equal to 12 characters
400Quotation is not foundQuotation does not exist or does not belong to this organization
400Customer ID does not match with the quotationCustomer ID mismatch between payin order and quotation
400Quotation has expiredQuotation has expired
400Quotation is already linked to another payinQuotation is already linked to another payin
500Internal Server ErrorInternal 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
​
quotation_id
string<uuid>
required

The unique identifier of the quotation

Example:

"2e104290-07c8-49f1-a5ca-0d27f0078f8a"

​
customer_id
string<uuid>
required

The unique identifier of the customer

Example:

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

​
utr
string
required

UTR of the bank transaction

Example:

"RATN0329SJDH0"

​
client_reference_id
string

Optional client reference ID for tracking

Example:

"testUser123"

Response

Payin created successfully

​
status
boolean
Example:

true

​
message
string
Example:

"Success"

​
data
object