---
title: "Place Order"
method: POST
path: "/v1/pay/address/create"
---

# Place Order

`POST /v1/pay/address/create`

Create an order. When the order currency and payment currency are consistent, create a direct address payment order; if the order currency and payment currency are inconsistent, create a convert address payment order.

## Headers

- `X-GatePay-Certificate-ClientId` string, required
- `X-GatePay-Signature` string, required
- `X-GatePay-Timestamp` string, required
- `X-GatePay-Nonce` string, required

## Request body

- CreateOrderRequest — Request for creating a payment order.
  - `merchantTradeNo` string, required — Merchant transaction ID in the merchant's system.
  - `currency` string — Crypto currency in uppercase. Required for crypto orders together with orderAmount. Omit when creating a pure fiat order with fiatCurrency and fiatAmount (system converts to USDT). Must equal payCurrency (or payCurrency is backfilled from this).
  - `orderAmount` string — Crypto order amount. Required together with currency for crypto orders. Omit for pure fiat orders that use fiatCurrency and fiatAmount.
  - `toleranceAmount` string — Tolerance Amount：If the remaining unpaid amount is less than or equal to the configured tolerance amount, the order will be automatically marked as Paid, with no further payment required.
  - `fiatCurrency` string — Fiat currency in uppercase, such as EUR, GBP, USD, CNY, JPY, AUD, CAD, CHF. For pure fiat orders, provide together with fiatAmount and omit currency/orderAmount.
  - `fiatAmount` string — Fiat order amount, with a maximum precision of 2 digits. For pure fiat orders, provide together with fiatCurrency and omit currency/orderAmount.
  - `surchargeAmount` string — Surcharge, a fee borne by the consumer.
  - `payCurrency` string — Payment currency. Optional; if omitted, it is backfilled from currency. If provided, it must equal currency.
  - `env` EnvRequest, required — Transaction source, optional values: APP, WEB, WAP, MINIAPP, OTHERS.
    - `terminalType` string, required — The terminal type used to create the order.
  - `goods` GoodsRequest, required — Goods.
    - `goodsName` string — Name of the goods
    - `goodsDetail` string — Details of the goods
  - `orderExpireTime` integer, required — Merchant-specified expiration time of the order, in milliseconds.
  - `returnUrl` string — Callback URL for payment completion.
  - `cancelUrl` string — Callback URL for payment cancellation.
  - `merchantUserId` integer, required — Unique consumer ID from the merchant’s platform.
  - `chain` string, required — Selected chain name.
  - `fullCurrType` string, required — Currency field that includes the chain name and corresponds to the specific currency on the specific chain.
  - `channelId` string, required — Client Name.

## Response `200`

SUCCESS

- CreateOrderResponse — Response parameters
  - `status` string
  - `code` string
  - `errorMessage` string
  - `data` object
    - `prepayId` string — ID of the created payment order
    - `terminalType` string — Terminal type of the created order
    - `expireTime` string — Expiration time of the payment order in milliseconds
    - `chain` Chain — The chain and address bound to the payment order for address payment
      - `chain_type` string — Name of the chain
      - `address` string — Receiving address of the chain binding to the order
      - `fullCurrType` string — The name of the chain including network information.
      - `memo` string — On-chain memo. For some chains (e.g. TON), parsed from the deposit address; may be omitted or empty when not applicable.

## Changes

- **2026-08-05** `00c10e31a4f9` — 1 info
  - added the optional property `data/chain/memo` to the response with the `200` status

[Change history](https://skmtc.dev/gate/apis/gatepay-address-payment-api/changes/v1/pay/address/create/post.md)

---

[API](https://skmtc.dev/gate/apis/gatepay-address-payment-api.md) · [All operations](https://skmtc.dev/gate/apis/gatepay-address-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gate/gatepay-address-payment-api/revisions/e66c448f796e/schema)