Skip to main content
POST
cURL

Create Quotation

The customer must be VERIFIED. Check their limit with Payin Limits before quoting.

Payment methods by currency

fiat and payment_method pick the market and the rail. deposit_instructions in the response follow the rail. When sent, bank_id is a VERIFIED account from Fetch Bank Accounts.

After quoting

  1. Show the user deposit_instructions, the exact sending_amount and the time left before expiry_time.
  2. The user pays from an account in their own KYC name, the exact amount, in one transfer. Otherwise the payin is refunded.
  3. Call Create Payin before expiry_time.

Error Codes and Messages

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"

payment_method
string
required

Payment method valid for the fiat: INR imps or upi; USD ach_pull, wire or rtp. Limits must be configured for it.

Example:

"IMPS"

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.

network
string
required

Blockchain network to deliver the crypto on, for example tron or polygon.

Example:

"tron"

bank_id
string<uuid>

Required when payment_method is ACH_PULL: the VERIFIED linked account from Fetch Bank Accounts, which Zapyd debits. Optional otherwise.

Example:

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

Response

Quotation created successfully

status
boolean
Example:

true

message
string
Example:

"Success"

data
object