Sign in
Payin Quotes

Create Payin Quote

post/v1/instances/{instance_id}/payin-quotes

Path parameters

instance_idstring required
Example:in_000000000000

Headers

Idempotency-Keystring

Optional key to safely retry this request without performing the action twice. Retrying with the same key and an identical body replays the original response; reusing a key with a different body returns an error. Keys are kept for 24 hours.

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

Request body

blockchain_wallet_idstring nullable
wallet_idstring nullable
currency_type'sender' | 'receiver' required
cover_feesboolean nullable

If true, the sender will cover the fees. If false, the customer will cover the fees.

request_amountinteger required

1000 represents 10.00, 2050 represents 20.50

payment_method'ach' | 'wire' | 'pix' | 'ted' | 'spei' | 'transfers' | 'pse' | 'international_swift' | 'rtp' required
token'USDC' | 'USDT' | 'USDB' required
partner_fee_idstring nullable
is_otcboolean nullable

If true, the payin quote is for an OTC (Over the Counter) transaction

funding_bank_account_idstring nullable

Plaid-connected bank account that funds the payin by ach pull. Only valid when payment_method is ach.

Example request

{
  "blockchain_wallet_id": "bw_000000000000",
  "wallet_id": "bl_000000000000",
  "currency_type": "sender",
  "cover_fees": true,
  "request_amount": 1000,
  "payment_method": "pix",
  "token": "USDC",
  "partner_fee_id": "pf_000000000000",
  "payer_rules": {
    "pix_allowed_tax_ids": [
      "123.456.789-09"
    ],
    "transfers_allowed_tax_id": "20-12345678-3",
    "pse_allowed_tax_ids": [
      "1234567890"
    ]
  },
  "funding_bank_account_id": "ba_000000000000"
}

Response

Payin Quote creation details

idstring required
expires_atnumber nullable required

Epoch unix timestamp that represents the final datetime to transaction be received on blockchain

commercial_quotationnumber nullable required

1 USD = 4.95 BRL

blindpay_quotationnumber nullable required

1 USD = 5.05 BRL (commercial quotation + (blindpay taxes))

receiver_amountnumber nullable required

10.10 USDC

sender_amountnumber nullable required

52.40 BRL needs to be sent in a pix transfer

partner_fee_amountnumber nullable

1.5 USDC

flat_feenumber nullable required

0.5 USDC

billing_fee_amountnumber nullable

BlindPay fee in cents accrued to your billing cycle (charged at the end of the month). Virtual account deposits below $100.00 always accrue here, so small deposits are delivered in full.

is_otcboolean nullable

If true, the payin quote is for an OTC (Over the Counter) transaction

Example response

{
  "id": "qu_000000000000",
  "expires_at": 1712958191,
  "commercial_quotation": 495,
  "blindpay_quotation": 505,
  "receiver_amount": 1010,
  "sender_amount": 5240,
  "partner_fee_amount": 150,
  "flat_fee": 50,
  "billing_fee_amount": 50
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.