Confirm charge

支付扣款接口

确认扣款接口

确认扣款接口

POST//unknown/V2022-03/confirmCharge

Header parameters

Body

application/json

paymentIntentReq

callbackUrlstring(1000)

服务端异步通知地址；最小长度为1，最大长度为1000，如：https://www.my.shopify.com/callbackUrl

Example: "https://www.my.shopify.com/callbackUrl"

customerIdstring(100)

客户ID； 商户可以通过接口/customers发起post创建； 注：tokenType=InitRecurring/RECURRING时，为必填项； 最大长度为100； 如：cus_1420997690607206400

Example: "cus_1420997690607206400"

customerPaymentMethodIdstring(100)

卡支付ID； 商户可以通过接口/payment_methods发起post创建； 注：tokenType=RECURRING时或者非PCI商户，为必填项；customerPaymentMethodId和customerPaymentMethod对象二选一； 如：pm_1420997693836820480

Example: "pm_1420997693836820480"

customerIp*string(50)

客户ip地址；最小长度为1，最大长度为50，如：192.168.0.1

Example: "192.168.0.1"

customerPaymentMethodPaymentMethodReq

goodsDetailsarray of 商品信息

商品信息； jsonObjectList，最多十个商品信息，大部分银行要求商品明细，请商户尽量收集并传过来

isMobilestring(1)

客户端类型； 0:web,1:h5,2:app_SDK,3：mini_app(小程序)，默认：0；固定长度为1，如：0

Example: 0

orderAmount*string(16)

商户订单金额； 最多两位小数，注：如果币种最小单位为元，则只能为整数；最小长度为1，最大长度为16，如：100.99

Example: 100.99

orderCurrency*string(3)

3位字母的ISO币种代码；固定长度为3，如：USD

Example: "USD"

orderNo*string(50)

商户订单号；最小长度为1，最大长度为50，如：12167001000000000001

Example: "12167001000000000000"

platformstring(10)

平台标识名称； 如果商户是SaaS平台，为必填项；最小长度为1，最大长度为10，如：Shopify

Example: "Shopify"

remarkstring(500)

订单备注；最大长度为500，如：remark

Example: "remark"

returnUrl*string(1000)

交易完成页面跳转地址；最小长度为1，最大长度为1000，如：https://www.my.shopify.com/redirectUrl

Example: "https://www.my.shopify.com/redirectUrl"

shippingShipping

tokenTypestring(100)

循环扣款类型； InitRecurring/RECURRING，首笔交易：InitRecurring，非首笔交易：RECURRING；最大长度为100

webSite*string(200)

商户店铺网址；最小长度为1，最大长度为200，如：https//www.my.shopify.com

Example: "https//www.my.shopify.com"

Response

200

OK

Body

*/*response body

codestring

返回码

Example: "success"

messagestring

返回信息

Example: "message response"

dataPaymentIntentResp

Request

JavaScriptCurlPython

const response = await fetch('//unknown/V2022-03/confirmCharge', {
    method: 'POST',
    headers: {
      "gateway-no": "text",
      "request-id": "text",
      "request-time": "text",
      "sign-info": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "customerIp": "192.168.0.1",
      "orderAmount": 100.99,
      "orderCurrency": "USD",
      "orderNo": "12167001000000000000",
      "returnUrl": "https://www.my.shopify.com/redirectUrl",
      "webSite": "https//www.my.shopify.com"
    }),
});
const data = await response.json();

Response

200

{
  "code": "success",
  "message": "message response",
  "data": {
    "maskCardNo": "422222********1111",
    "orderAmount": "100",
    "orderCurrency": "USD",
    "orderInfo": "is order info",
    "orderNo": "12167001000000000000",
    "orderStatus": "success",
    "redirectUrl": "https://3desurl.com",
    "remark": "remark",
    "riskInfos": "is risk info",
    "tradeNo": "2022022416544064513805"
  }
}

请求报文示例

confirmCharge.sh

curl --request POST \
  --url https://{paymentApiUrl}/V2022-03/confirmCharge \
  --header 'Content-Type: application/json' \
  --header 'request-id: 58675' \
  --header 'request-time: 1651888520935' \
  --header 'gateway-no: 12345001' \
  --header 'sign-info: 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822B' \
  --data '{
    "callbackUrl": "https://sandbox-pay.asiabill.com/services/v3/CallResult",
    "customerId": "cus_1526760517237616640",
    "customerIp": "192.168.3.27",
    "customerPaymentMethodId": "pm_1526760521989763072",
    "goodsDetails": [
        {
            "goodsCount": "1000",
            "goodsPrice": "154.23",
            "goodsTitle": "apple"
        }
    ],
    "isMobile": "0",
    "orderAmount": "194.13",
    "orderCurrency": "USD",
    "orderNo": "NEW_API1916436298025",
    "platform": "",
    "remark": "TEST",
    "returnUrl": "https://sandbox-pay.asiabill.com/services/v3/RedirectResultTest?bankCode=TestBankCode",
    "shipping": {
        "address": {
            "city": "NEWARK VALLEY",
            "country": "US",
            "line1": "4348  Calico Drive",
            "postalCode": "13811",
            "state": "NY"
        },
        "firstName": "Di Mo",
        "lastName": "Shi",
        "phone": "509-675-8948"
    },
    "webSite": "www.AsiaBill.com"
}'

结果对象属性描述

property name	type	description
code	String	返回码
message	String	返回信息
data
redirectUrl	String	跳转URL（3D验证URL、本地支付跳转URL），如果此值不为空，则商户需要跳转客户到此地址
orderStatus	String	【交易状态】 待处理：pending 成功：success 失败：fail
orderInfo	String	交易状态描述信息
remark	String	备注
tradeNo	String	流水订单号
orderNo	String	商户订单号
orderAmount	String	商户订单金额
orderCurrency	String	商户订单币种
riskInfos	String	风控信息
maskCardNo	String	卡号前六后四