Creating a fiat payin order

POST /orders/deposit API

curl --request POST \
     --url https://sandbox-api.transfi.com/v2/orders/deposit \
     --header 'MID: ABCDEF_NA_NA' \
     --header 'accept: application/json' \
     --header 'authorization: Basic dHJhbnNmaV9xYT' \
     --header 'content-type: application/json' \
     --data '
{
  "paymentType": "bank_transfer",
  "amount": 30,
  "balanceCurrency": "USDC",
  "currency": "EUR",
  "email": "[email protected]",
  "purposeCode": "expense_or_medical_reimbursement",
  "redirectUrl": "https://www.transfi.com",
  "sourceUrl": "https://transfi.com",
  "headlessMode": false,
  "invoiceId": "IN-2508181321142221384"
}
'
{
  "orderId": "OR-1234567890123456789",
  "paymentUrl": "https://sandbox-pay-widget.transfi.com/pay?paytoken=1a1a1aa1a-1a1a-1a1a-1a1a1a",
  "partnerContext": {},
  "redirectUrl": "https://www.transfi.com"
}
  • With the above payload, you will receive a paymentURL in the response that will take users to TransFi hosted checkout page.
  • With the Order ID you can fetch the status of the order.
  • payment_code and payment_type are optional fields. If you pass these details then you can pre-select the payment method for your users.

TransFi hosted page without passing payment_code & payment_type

TransFi hosted page after passing payment_code & payment_type