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

# Alipay In-App Payments

> Integration guide for Alipay in-app payments using AlipayHK or AlipayCN SDK.

This guide explains how to integrate Alipay In-App payments using the Alipay SDK (AlipayHK or AlipayCN). This payment method is used within a native app environment and provides a seamless user experience.

## SDK Download

To begin integration, download the official SDK packages below:

* [Alipay Overseas SDK Documentation](https://global.alipay.com/docs/ac/app/client_integration)
* [AlipayHK SDK Download](https://global.alipay.com/docs/ac/app_hk/download)
* [AlipayHK SDK Trigger Guide](https://global.alipay.com/docs/ac/hkapi/securitypay_pay)

***

## HTTP Request

**Endpoint** : `/trade/v1/payment`\
**Method** : `POST`

| PayType  | Description                        |
| -------- | ---------------------------------- |
| `801110` | Alipay In-App (Overseas Merchants) |
| `801510` | Alipay In-App (HK Merchants)       |

## Required Parameters

| Parameter      | Required | Type        | Description                                     |
| -------------- | -------- | ----------- | ----------------------------------------------- |
| `txamt`        | Yes      | Int         | Transaction amount in cents. Example: 100 = \$1 |
| `txcurrcd`     | Yes      | String(3)   | Currency code (e.g. HKD)                        |
| `pay_type`     | Yes      | String(6)   | Use 801110 for Alipay CN, 801510 for AlipayHK   |
| `out_trade_no` | Yes      | String(128) | Unique merchant transaction ID                  |
| `txdtm`        | Yes      | String(20)  | Format: `YYYY-MM-DD hh:mm:ss`                   |
| `goods_name`   | Yes      | String      | Product name                                    |
| `return_url`   | Yes      | String      | Redirect URL after payment                      |
| `seller_id`    | No       | String      | Alipay seller account                           |
| `mchid`        | No       | String(16)  | QFPay assigned Merchant ID                      |

See [Common Payment Parameters](/integration/api-reference/request-format) for shared fields.

***

## Optional Parameters

| Parameter Name      | Parameter Key  | Required                 | Type       | Description                                                                                                   |
| ------------------- | -------------- | ------------------------ | ---------- | ------------------------------------------------------------------------------------------------------------- |
| Product Description | `goods_info`   | No                       | String     | Required by Alipay. Special characters are not allowed.                                                       |
| Payment Tag         | `pay_tag`      | No                       | String(16) | Default: ALIPAYHK<br />For Alipay Mainland use: ALIPAYCN                                                      |
| Order Expiry Time   | `expired_time` | No<br />(Main-scan only) | String(3)  | Expiration time in minutes. Default is 30 minutes. Min: 5, Max: 120.<br />Applicable to WeChat Pay and Alipay |

## Sample Request (Form Payload)

```plaintext theme={null}
txamt=1
&txcurrcd=HKD
&pay_type=801510
&out_trade_no=052711570017898
&txdtm=2021-05-27 11:57:00
&goods_name=goods_name
&goods_info=goods_info
&mchid=nDB64h9qJ1An
&trade_name=trade_name
&goods_detail=goods_detail
&return_url=https://www.qfpay.global/
&pay_tag=ALIPAYHK
&seller_id=testoverseas9191@alipay.com
```

## Response Fields (pay\_params)

These fields are returned by QFPay and should be passed into the Alipay SDK.

| Parameter Key              | Sub Parameter Key             | Description                                                                                           |
| -------------------------- | ----------------------------- | ----------------------------------------------------------------------------------------------------- |
| `pay_params`               | `partner`                     | Partner ID                                                                                            |
|                            | `seller_id`                   | Unique Alipay user ID of the receiving account                                                        |
|                            | `subject`                     | Product title / trade title / order title                                                             |
|                            | `body`                        | Detailed description of the transaction. For multiple items, concatenate descriptions into this field |
|                            | `total_fee`                   | Total order amount                                                                                    |
|                            | `notify_url`                  | Notification callback URL                                                                             |
|                            | `service`                     | Service name                                                                                          |
|                            | `cardcd`                      | Card number                                                                                           |
|                            | `payment_type`                | Payment type                                                                                          |
|                            | `_input_charset`              | Character encoding format                                                                             |
|                            | `it_b_pay`                    | Custom timeout parameter                                                                              |
|                            | `return_url`                  | Redirect URL after payment                                                                            |
|                            | `payment_inst`                | Payment institution                                                                                   |
|                            | `currency`                    | Currency code                                                                                         |
|                            | `product_code`                | Product code                                                                                          |
|                            | `sign`                        | RSA signature (Required)                                                                              |
|                            | `sign_type`                   | Signature type                                                                                        |
|                            | `secondary_merchant_id`       | Secondary merchant ID                                                                                 |
|                            | `secondary_merchant_name`     | Secondary merchant name                                                                               |
|                            | `secondary_merchant_industry` | Secondary merchant industry                                                                           |
| `chnlsn`                   |                               | Channel transaction number                                                                            |
| Common Response Parameters | —                             | —                                                                                                     |

## Sample QFPay Response

```json theme={null}
{
  "pay_type": "801510",
  "sysdtm": "2021-05-27 11:57:02",
  "paydtm": "2021-05-27 11:57:02",
  "udid": "qiantai2",
  "txcurrcd": "HKD",
  "txdtm": "2021-05-27 11:57:00",
  "txamt": "1",
  "resperr": "交易成功",
  "respmsg": "",
  "out_trade_no": "052711570017898",
  "syssn": "20210527154100020004180921",
  "pay_params": {
    "body": "goods_info",
    "forex_biz": "FP",
    "seller_id": "2088231067382451",
    "secondary_merchant_id": "1000007081",
    "service": "mobile.securitypay.pay",
    "payment_inst": "ALIPAYHK",
    "it_b_pay": "30m",
    "secondary_merchant_name": "IFlare Hong Kong Limited (external) - online",
    "_input_charset": "UTF-8",
    "sign": "iU1yXUnsCK7rJAu0DoN61arVexbIfo3GLR5jr3QzjkZ29INSPhcA4e%2F2%2BdPrsf5huzQAkxVKP0CTfvaGPMYqNkxmhoaJWUH0ZhgYDgKugMvtweBvRqOX2W0h3A%2F%2FIdJuxeyOAuh7bHiuazSB3ZH%2BEQwRGP%2Bkk8Jpha930gHwPtw%3D",
    "currency": "HKD",
    "out_trade_no": "20210527154100020004180921",
    "payment_type": "1",
    "total_fee": 0.01,
    "sign_type": "RSA",
    "notify_url": "https://test-o2-hk.qfapi.com/trade/alipay_hk/v1/notify",
    "partner": "2088231067382451",
    "secondary_merchant_industry": "5941",
    "product_code": "NEW_WAP_OVERSEAS_SELLER",
    "return_url": "https://www.qfpay.global/",
    "subject": "goods_name"
  },
  "respcd": "0000",
  "chnlsn": "",
  "cardcd": ""
}
```

## Using Alipay SDK

After receiving the `pay_params` in the response, construct the `orderInfo` string required by the SDK in the following format:

1. Join all fields in the format: `key="value"`
2. Sort keys in ascending order (alphabetical)
3. Concatenate with `&`
4. Place `sign` and `sign_type` at the end

### Sample

```plaintext theme={null}
_input_charset="UTF-8"&body="goods_info"&currency="HKD"&forex_biz="FP"&it_b_pay="30m"&notify_url="https://test-o2-hk.qfapi.com/trade/alipay_hk/v1/notify"&out_trade_no="20210527154100020004180921"&partner="2088231067382451"&payment_inst="ALIPAYHK"&payment_type="1"&product_code="NEW_WAP_OVERSEAS_SELLER"&return_url="https://www.qfpay.global/"&secondary_merchant_id="1000007081"&secondary_merchant_industry="5941"&secondary_merchant_name="IFlare Hong Kong Limited (external) - online"&seller_id="2088231067382451"&service="mobile.securitypay.pay"&subject="goods_name"&total_fee="0.01"&sign="iU1yXUnsCK7rJAu0DoN61arVexbIfo3GLR5jr3QzjkZ29INSPhcA4e%2F2%2BdPrsf5huzQAkxVKP0CTfvaGPMYqNkxmhoaJWUH0ZhgYDgKugMvtweBvRqOX2W0h3A%2F%2FIdJuxeyOAuh7bHiuazSB3ZH%2BEQwRGP%2Bkk8Jpha930gHwPtw%3D"&sign_type="RSA"
```

<Note>
  Make sure you:

  * Follow the correct SDK version and region (HK vs CN)
  * Use the exact `key` names and `values` returned in `pay_params`
  * Keep your sign logic consistent with Alipay SDK format
</Note>