Saltar al contenido principal
POST
Child Address Create Payment Order
Envía como additionalData el objeto completado a partir del esquema de requisitos de la cotización. Con una sesión, la orden hereda el customerId proporcionado en la cotización. El KYC en línea enviado para un cliente existente se guarda para reutilizarlo con el mismo proveedor y corredor.
Para identidad, sesiones, recuperación y comisiones, consulte Flujos fiat para clientes.

Autorizaciones

x-api-key
string
header
requerido

Parámetros de ruta

walletId
string<uuid>
requerido

Wallet identifier.

addressId
string<uuid>
requerido

Child address identifier.

Cuerpo

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>
requerido

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

amountSide
enum<string>
predeterminado:target

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

Opciones disponibles:
source,
target
currency
string
obsoleto

ISO 4217 fiat currency paid by the customer.

Required string length: 3
Ejemplo:

"NGN"

assetId
string<uuid>
obsoleto

Stablecoin asset to settle.

Ejemplo:

"ae455f23-3824-4125-baab-d158315cbcbd"

amount
string
obsoleto

Stablecoin amount to receive, encoded as a decimal string.

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

"100.00"

rail
enum<string>
obsoleto

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

Opciones disponibles:
one_time_virtual_account,
payment_link,
qr_code
reference
string

Unique client reference used for reconciliation and safe retries.

Maximum string length: 250
Ejemplo:

"dep_20260719_001"

validityTimeMinutes
number

Time before the payment instructions expire.

Rango requerido: 30 <= x <= 1440
Ejemplo:

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.

Ejemplo:
metadata
object

Your application metadata returned with the order.

Ejemplo:
provider
string
obsoleto

Optional provider slug. Omit for automatic routing.

Ejemplo:

"example-provider"

Respuesta

Created successfully.

message
string
requerido

Human-readable result.

Ejemplo:

"Payment order created successfully"

data
object
requerido
status
boolean
requerido
Ejemplo:

true