submitPay

2026-09-15 15:08

POST /v1/payments/submitPay

调用此接口发起支付请求。系统会根据请求参数处理交易，并返回支付状态、支付链接（用于唤起收银台）或唯一的支付请求 ID。

结构

报文由报文头和报文体组成。本文主要介绍报文体结构信息，有关报文头的结构信息，请参阅：

注意：将每个参数（除数组外）的数据类型设置为字符串，即参数的值必须使用英文双引号（" "）包裹起来。例如：

如果参数的数据类型为整数属性，且其值为 20，设置为 "20"。
如果参数的数据类型为布尔属性，且其值为 true，设置为 "true"。

入参

paymentSessionId String REQUIRED

支付会话 ID。

更多信息：

最大长度：64 字符

paymentAmount Amount

支付金额。

order Order

订单信息。

出参

result Result REQUIRED

接口调用的结果。

paymentRequestId String REQUIRED

商户为识别支付请求分配的专属 ID。

更多信息：

最大长度：64 字符

paymentId String REQUIRED

APO 为识别一次支付分配的专属 ID。

更多信息：

最大长度：64 字符

paymentAmount Amount

支付金额。

paymentCreateTime Datetime

创建支付的日期和时间。

更多信息：

值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。

applinkUrl URL

应用安装成功时，跳转应用的链接，安装失败则跳转至 WAP 页面。对于 Android，该链接是 Native App Link。对于 iOS，该链接是 Universal Link。

更多信息：

最大长度：2048 字符

normalUrl URL

将用户重定向到默认浏览器或嵌入式 WebView 中的 WAP 或 WEB 页面的链接。

更多信息：

最大长度：2048 字符

schemeUrl URL

在 Android 或 iOS 系统中，应用安装完成后，将用户重定向到应用的 URL scheme。

更多信息：

最大长度：2048 字符

acquirerInfo AcquirerInfo

处理该支付的收单机构信息。

API Explorer

请求

URL

Method

POST

{
  "paymentSessionId": "PAYMENT_SESSIONID_20260129144822724_AUTO",
  "paymentAmount": {
    "currency": "SGD",
    "value": "120"
  },
  "order": {
    "orderAmount": {
      "currency": "SGD",
      "value": "100"
    },
    "orderTaxAmount": {
      "currency": "SGD",
      "value": "10"
    },
    "orderDiscountAmount": {
      "currency": "SGD",
      "value": "20"
    },
    "shipping": {
      "shippingFee": {
        "currency": "SGD",
        "value": "30"
      }
    }
  }
}

响应

{
  "result": {
    "resultStatus": "U",
    "resultCode": "PAYMENT_IN_PROCESS",
    "resultMessage": "payment in process"
  },
  "paymentId": "2022091619401080010018861020428****",
  "paymentRequestId": "QvagvxbRBZdJ00U48KOByGChhMgC8f5BNF3Cl86OIXljytdNZD6flwC7nU5U****",
  "applinkUrl": "",
  "schemeUrl": "",
  "normalUrl": "https://demo-domain.alipay.com/page/apm-factor/code.html?merchantId=188oOYrCvQObmAa9gqme42YsFhHjpexPusV0TSebnZ9Nik%3D&paymentRequestId=w9iOyEkQ7yFSXyrc4UtVvlRUf%2Bt7UTVMY7BkUzeqQP2oGXIzuGhhv8cqbOKYIQgST8oKUsbd4x2Rr8ai6DgfZMYbjonojR6N2F9JRuBYrxg%3D&clientId=5J5Y63382Y3HH006786",
  "paymentAmount": {
    "currency": "BRL",
    "value": "96080"
  },
  "paymentCreateTime": "2022-09-15T20:20:20-07:00",
  "acquirerInfo": {
    "acquirerMerchantId": "21811100024730H6",
    "acquirerName": "ALIPAY",
    "acquirerResultCode": "SUCCESS",
    "acquirerResultMessage": "success",
    "acquirerTransactionId": "202508201140108001001814F0276126015",
    "referenceRequestId": "PAYMENT_20250820143310572_AUTO"
  }
}

结果/错误代码

*resultCode*	*resultStatus*	*resultMessage*	处理建议
`SUCCESS`	`S`	成功支付已成功，无需进一步操作。	无需操作。
`PAYMENT_IN_PROCESS`	`U`	支付处理中支付正在进行中。	获取任意 URL（appLinkUrl, normalUrl, schemeUrl）并打开收银台页面。若未返回 URL，请使用新的 paymentRequestId 重试支付 API。若问题持续，请联系 APO 技术支持。
`PROCESS_FAIL`	`F`	处理失败发生了一般性业务失败。	请勿重试。通常需要人工干预，建议联系 APO 技术支持排查问题。
`UNKNOWN_EXCEPTION`	`U`	未知异常因未知原因导致 API 调用失败。	请重试调用接口。若未解决，请联系 APO 技术支持。
`ORDER_STATUS_INVALID`	`F`	订单状态无效因订单状态无效，交易无法继续处理。	检查交易订单状态，或联系 APO 技术支持获取详细原因。
`INVALID_MERCHANT_STATUS`	`F`	商户状态无效因存在限制，商户状态异常。	联系 APO 技术支持获取详细原因。
`CARD_NOT_SUPPORTED`	`F`	不支持的银行卡交易所使用的银行卡不被支持。	请更换其他银行卡进行支付。
`RISK_REJECT`	`F`	风控拒绝因风控原因交易无法继续。若用户已付款，交易将被退款。	若用户在两周内未收到退款，请联系 APO 技术支持。
`DO_NOT_HONOR`	`F`	发卡行拒绝支付被发卡行拒绝。	请尝试更换其他银行卡重试，或联系发卡行。
`USER_AMOUNT_EXCEED_LIMIT`	`F`	超出用户限额支付金额超过了用户的支付限额。	请使用小于或等于账户可用余额的金额创建新支付，或联系 APO 技术支持。
`FRAUD_REJECT`	`F`	欺诈拒绝因风控原因交易无法继续。若用户已付款，交易将被退款。	满足以下任一条件时请联系 APO 技术支持：您想要发起申诉。用户在两周内未收到退款。
`USER_STATUS_ABNORMAL`	`F`	用户状态异常钱包侧的用户状态异常。	联系 APO 技术支持以了解具体原因。
`PARAM_ILLEGAL`	`F`	参数非法缺少必要参数或存在非法参数（如非数字输入、无效日期、参数长度或类型错误等）。	检查并验证当前 API 的请求字段（包括请求头和请求体）是否正确传递且有效。