---
title: "Child Address Create Payment Order"
method: POST
path: "/v1/wallets/{walletId}/addresses/{addressId}/deposit/fiat/orders"
tags: ["Deposit Fiat"]
---

# Child Address Create Payment Order

`POST /v1/wallets/{walletId}/addresses/{addressId}/deposit/fiat/orders`

## Path parameters

- `walletId` string, uuid, required
- `addressId` string, uuid, required

## Request body

- CreateProviderPaymentOrderDto
  - `currency` string, required — ISO 4217 fiat currency paid by the customer.
  - `assetId` string, uuid, required — Stablecoin asset to settle.
  - `amount` string, required — Stablecoin amount to receive, encoded as a decimal string.
  - `rail` 'one_time_virtual_account' | 'payment_link' | 'qr_code', required — Supported fiat collection rail.
  - `reference` string — Unique client reference used for reconciliation and safe retries.
  - `validityTimeMinutes` number — Time before the payment instructions expire.
  - `code` string
  - `passkeyResponse` object
  - `customerId` string, uuid — Existing Blockradar customer identifier.
  - `customer` CreateProviderPaymentOrderCustomerDto
    - `name` string — Customer full name.
    - `email` string, email — Customer email address.
    - `phone` string — Customer phone number in international format.
  - `additionalData` object — Values collected from the quote requirements schema.
  - `metadata` object — Your application metadata returned with the order.
  - `provider` string — Optional provider slug. Omit for automatic routing.

## Response `201`

Created successfully.

- PaymentOrderCreateResponse
  - `statusCode` integer, required
  - `message` string, required — Human-readable result.
  - `data` PaymentOrder, required
    - `id` string, uuid, required — Payment order identifier.
    - `type` string, required — Order type.
    - `rail` 'one_time_virtual_account' | 'payment_link' | 'qr_code', required — Supported fiat collection rail.
    - `reference` string, required — Client-provided or generated idempotency reference.
    - `providerReference` string, nullable — Provider order reference.
    - `transactionId` string, uuid, nullable — Settlement transaction identifier.
    - `status` 'pending' | 'paid' | 'processing' | 'expired' | 'failed' | 'cancelled', required — Current payment-order lifecycle status.
    - `currency` string, required — ISO 4217 fiat currency.
    - `amount` string, required — Stablecoin amount to settle.
    - `amountFiat` string, required — Fiat equivalent before fees.
    - `feeFiat` string, required — Fiat fee.
    - `amountFiatPayable` string, required — Total fiat amount payable.
    - `amountFiatReceived` string, nullable — Fiat amount received.
    - `amountSettled` string, nullable — Stablecoin amount settled.
    - `expiresAt` string, date-time, nullable — Payment expiry time.
    - `paymentInstructions` PaymentInstructions
      - `type` 'one_time_virtual_account' | 'payment_link' | 'qr_code', required — Supported fiat collection rail.
      - `bank` object, nullable
        - `name` string, required — Bank name.
        - `code` string, nullable — Bank code.
        - `accountName` string, required — Account holder name.
        - `accountNumber` string, required — Account number.
      - `paymentLink` object, nullable
        - `url` string, uri, required — Hosted payment URL.
      - `qrCode` object, nullable
        - `payload` string, nullable — Raw QR payload.
        - `imageUrl` string, uri, nullable — QR image URL.
      - `expiresAt` string, date-time, nullable — Instruction expiry time.
      - `metadata` object, nullable
    - `metadata` object, nullable
    - `provider` object, required
      - `id` string, uuid, required — Provider identifier.
      - `slug` string, required — Provider slug.
      - `name` string, required — Provider name.
    - `wallet` object, required
      - `id` string, uuid, required — Wallet identifier.
      - `address` string, required — Wallet blockchain address.
    - `address` object, nullable
      - `id` string, uuid, required — Child address identifier.
      - `address` string, required — Child blockchain address.
    - `asset` object, required
      - `id` string, uuid, required — Asset identifier.
      - `symbol` string, required — Asset symbol.
      - `name` string, required — Asset name.
    - `customer` object, nullable
      - `id` string, uuid, required — Customer identifier.
    - `createdAt` string, date-time, required — Creation timestamp.
    - `updatedAt` string, date-time, required — Last update timestamp.

---

[API](https://skmtc.net/blockradar/apis/blockradar-documentation.md) · [All operations](https://skmtc.net/blockradar/apis/blockradar-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blockradar/blockradar-documentation/revisions/97f95b4cfc0d/schema)