GuidesAPI Reference
API Reference
  1. CrossBill API
  2. Orders

POST orders/create

post
https://api.crossbill.com/orders/create

Creates a fiat-to-crypto on-ramp order for a KYC-verified end user. The response contains the SEPA payment details the end user must use to fund the order.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
integer
required
≥ 1

Amount for on-ramp. Must be a whole number and within the allowed range for your merchant account.

string
required
length ≥ 3

Currency of the order amount. Currently only EUR is supported.

string
required

EVM wallet address that will receive the USDC payout.

string
required

UUID of a KYC-verified end user belonging to your merchant account.

Responses

400

Invalid request.

401

Invalid or expired token.

406

Planned error. Possible errors:

  • Amount must be a whole number. — amount is not an integer
  • Amount is outside the allowed range for this merchant. Min: X, Max: Y — amount below min or above max
  • The provided kycUserUuid does not belong to a verified user for this merchant. — KYC user not found or not verified
  • Insufficient liquidity. Please try again shortly. — temporary platform issue
  • Payment provider configuration error. Please contact support. — internal config issue
  • KYC verification service unavailable. Please try again. — KYC service temporarily unreachable
500

Internal server error.

Updated 15 days ago

Did this page help you?
Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 15 days ago

Did this page help you?