Skip to main content
POST
Master Wallet Create Payment Order
Envoyez comme additionalData l’objet complété à partir du schéma d’exigences du devis. Avec une session, l’ordre hérite du customerId fourni au devis. Si le fournisseur exige un KYC inline, incluez-le dans additionalData ; Blockradar l’enregistre pour qu’il soit réutilisé par le même client de l’entreprise, le même fournisseur et le même corridor.

Autorisations

x-api-key
string
header
requis

Paramètres de chemin

id
string<uuid>
requis

Wallet identifier.

Corps

application/json
sessionId
string<uuid>

Session ID returned by the deposit quote. Recommended instead of resending routing fields.

currency
string
obsolète

ISO 4217 fiat currency paid by the customer.

Required string length: 3
Exemple:

"NGN"

assetId
string<uuid>
obsolète

Stablecoin asset to settle.

Exemple:

"ae455f23-3824-4125-baab-d158315cbcbd"

amount
string
obsolète

Stablecoin amount to receive, encoded as a decimal string.

Pattern: ^\d+(\.\d+)?$
Exemple:

"100.00"

rail
enum<string>
obsolète

Collection method. Use one of the rails returned by the rails endpoint.

Options disponibles:
one_time_virtual_account,
payment_link,
qr_code
reference
string

Unique client reference used for reconciliation and safe retries.

Maximum string length: 250
Exemple:

"dep_20260719_001"

validityTimeMinutes
number

Time before the payment instructions expire.

Plage requise: 30 <= x <= 1440
Exemple:

30

code
string
passkeyResponse
object
customerId
string<uuid>

Existing Blockradar customer identifier. When used with a deposit session, Blockradar can reuse and persist provider-specific KYC for this customer and the provider-inferred corridor.

Exemple:

"18d2f159-e0cd-4a45-b735-e9dfe0f7520a"

customer
object
additionalData
object

Values collected from the quote requirements schema.

Exemple:
metadata
object

Your application metadata returned with the order.

Exemple:
provider
string
obsolète

Optional provider slug. Omit for automatic routing.

Exemple:

"example-provider"

Réponse

200 - application/json

Successful response.

statusCode
integer
requis
Exemple:

200

message
string
requis

Human-readable result.

Exemple:

"Payment order created successfully"

data
object
requis