> ## Documentation Index
> Fetch the complete documentation index at: https://docs-en.basswallet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Payment

> Create a payment order and generate a payment URL for receiving funds.

### Endpoint

**POST** `/v1/account/payment`

<Tip>
  Payment orders can be created as either fixed-amount or variable-amount orders. If the `amount` is provided, it is a fixed-amount order; otherwise, it is a variable-amount order where the user can decide the payment amount. You can choose the type based on your business requirements.
</Tip>

### Request Parameters

| Parameter           | Type     | Required | Description                                                                                        |
| ------------------- | -------- | -------- | -------------------------------------------------------------------------------------------------- |
| **amount**          | `String` | No       | Payment amount. If empty, it means the payment amount is not fixed.                                |
| **tokenName**       | `String` | Yes      | Name of the cryptocurrency to be paid, e.g., `USDT`, `BTC`.                                        |
| **chainName**       | `String` | Yes      | Name of the blockchain network, e.g., `Ethereum`, `Bsc`.                                           |
| **businessId**      | `String` | No       | Merchant-defined unique order ID, supporting alphanumeric characters (max length: 32).             |
| **timestamp**       | `Long`   | Yes      | UNIX timestamp (in milliseconds).                                                                  |
| **displayInfo**     | `String` | No       | Merchant-defined description for the order, displayed on the payment page for user reference.      |
| **autoReturn**      | `String` | No       | Whether to automatically redirect to the merchant page after successful payment. Default: `False`. |
| **returnUrl**       | `String` | No       | URL to redirect to after payment completion. Must start with `http` or `https`.                    |
| **expiryMinutes**   | `String` | No       | Order expiration time (in minutes). Default: 1 hour. Minimum: 1 minute. Maximum: 5 days.           |
| **webhookUrl**      | `String` | No       | Callback URL for payment completion, overriding the globally configured merchant callback.         |
| **displayLanguage** | `String` | No       | Display language for the payment page. Default: `en-US`. Supported: `zh-CN`, `en-US`.              |

### Response Parameters

| Parameter       | Type     | Required | Description                                               |
| --------------- | -------- | -------- | --------------------------------------------------------- |
| **redirectUrl** | `String` | Yes      | Redirect URL for the payment page.                        |
| **status**      | `String` | Yes      | Status of the order.                                      |
| **id**          | `String` | Yes      | Platform-defined order ID.                                |
| **amount**      | `String` | No       | Payment amount (only if a fixed amount is set).           |
| **minAmount**   | `String` | No       | Minimum payment amount (only for variable-amount orders). |
| **tokenName**   | `String` | Yes      | Cryptocurrency for payment.                               |
| **chainName**   | `String` | Yes      | Blockchain name.                                          |
| **address**     | `String` | Yes      | Recipient address.                                        |
| **businessId**  | `String` | No       | Merchant-defined business ID.                             |
| **returnUrl**   | `String` | No       | Merchant-defined return URL.                              |
| **displayInfo** | `String` | No       | Merchant-defined display information.                     |
| **createdDate** | `Long`   | Yes      | Order creation time (UTC).                                |
| **expiryDate**  | `Long`   | Yes      | Order expiration time (UTC).                              |

### Response Example

```json theme={null}
{
    "code": 200,
    "msg": "success",
    "timestamp": "1735119737092",
    "data": {
        "createdDate": 1735119737043,
        "expiryDate": 1735123337038,
        "redirectUrl": "https://pay.baaswallet.io/payin/d761cd01-04ab-45e1-b0a8-9e1bc7f84d8d",
        "status": "Pending",
        "id": "626945553984524288",
        "amount": "99.99",
        "tokenName": "USDT",
        "chainName": "Ethereum",
        "address": "0xE8f8f66DB0701a1cE1E2675F833859316C232bD5",
        "businessId": "Bjxc6666",
        "returnUrl": "",
        "displayInfo": "Membership Service"
    }
}
```