Passer au contenu principal
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.
Pour l’identité, les sessions, la reprise et les frais, consultez Flux fiat pour les clients.

Autorisations

x-api-key
string
header
requis

Paramètres de chemin

id
string<uuid>
requis

Wallet identifier.

Corps

application/json

Supply sessionId, or all original routing fields. Repeated fields must match the session. Customer identity is inherited from the session.

sessionId
string<uuid>
requis

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

amountSide
enum<string>
défaut:target

source fixes the total fiat payable; target fixes the crypto amount to settle. Defaults to target.

Options disponibles:
source,
target
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>

Optional existing active customer owned by the authenticated business. Omit for the business-owned flow. Start a new session to change customer identity.

customer
object

Optional payer contact details (name/email/phone); not a substitute for customerId and provider customer onboarding.

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

Successful response.

message
string
requis

Human-readable result.

Exemple:

"Payment order created successfully"

data
object
requis
status
boolean
requis
Exemple:

true