Passer au contenu principal
POST
Child Address 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. Le KYC inline soumis pour un client existant est enregistré pour être réutilisé par 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

walletId
string<uuid>
requis

Wallet identifier.

addressId
string<uuid>
requis

Child address 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

Created successfully.

message
string
requis

Human-readable result.

Exemple:

"Payment order created successfully"

data
object
requis
status
boolean
requis
Exemple:

true