ApplePay 直接支付接口

简述

• 本接口基于商户有收银台，商户直接调用 ApplePay 的直接支付
• 流程：商户需要提交收银台域名，我公司配置商户域名。

商户下单->查询支付信息->ApplePay 获取 Token->提交 ApplePay 支付信息->结果回调（结果查询）

注意

查询支付信息，ApplePay 获取 Token，提交 ApplePay 支付信息，三个接口的 deviceId 需要一致

查询支付信息

请求 URL

• /pay/merchant/inquiryPaymentInfo

请求参数

参数名	必选	类型	最大长度	说明
merchantId	是	String	32	商户编码(平台分配)
orderId	是	String	64	平台订单号
subMerId	否	String	32	二级商户号 如存在则上送
paymentType	是	String	64	支付方式。 取值内容：附录-支付方式
deviceId	是	String	100	客户设备 ID
deviceIp	是	String	64	客户设备的 IP 地址
deviceBrowser	否	String	255	浏览器信息
deviceGPS	否	String	64	客户设备的位置信息

请求示例

{
  "merchantId": "M12345678",
  "orderId": "202412131543011234578",
  "subMerId": "",
  "deviceId": "f1c706dc-5424-4904-a482-80af53e5303e",
  "deviceIp": "14.145.171.43",
  "deviceBrowser": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Safari/605.1.15",
  "deviceGPS": "23.12591056258577/113.36802628828976",
  "paymentType": "applepay"
}

响应参数

• data

参数名	类型	说明
merchantId	String	商户编码
orderId	String	平台交易订单号
tranType	String	支付类型
paymentType	String	支付方式
currency	String	订单币种
amount	String	订单金额

响应示例

{
  "code": 10000,
  "message": "success",
  "data": {
    "amount": "5.000000",
    "merchantId": "MER50047224",
    "orderId": "ORD250924074856861090734",
    "currency": "SAR",
    "tranType": "online_payin",
    "paymentType": "applepay"
  }
}

ApplePay 获取 Token

请求 URL

• /pay/merchant/applePayGetToken

请求参数

参数名	必选	类型	说明
merchantId	是	String	商户编码(平台分配)
orderId	是	String	平台订单号
subMerId	否	String	二级商户号 如存在则上送
applepayURL	是	String	Applepay 的 URL
payerEmail	是	String	付款人邮箱

请求示例

{
  "merchantId": "M12345678",
  "orderId": "202412131543011234578",
  "subMerId": "",
  "applepayURL": "https://applepay.com/xxxx/xxxx/xxx",
  "payerEmail": "12345@163.com"
}

响应参数

• data

参数名	类型	最大长度	说明
merchantId	String	32	商户编码
orderId	String	32	平台交易订单号
paymentOrderId	String	32	平台支付订单号
applepayToken	String	-	ApplePay 的 Token

响应示例

{
  "code": 10000,
  "message": "success",
  "data": {
    "merchantId": "MER50047224",
    "orderId": "ORD250924074856861090734",
    "paymentOrderId": "PAY250924075848566419115",
    "applepayToken": ""
  }
}

提交支付请求

请求 URL

• /pay/merchant/applePayAuthEntication

请求参数

参数名	必选	类型	最大长度	说明
merchantId	是	String	32	商户编码(平台分配)
orderId	是	String	64	平台订单号
paymentOrderId	是	String	64	平台支付订单号
subMerId	否	String	32	二级商户号 如存在则上送
deviceId	是	String	100	客户设备 ID，与获取 Token 时一致
applepayEncData	是	String	100	ApplePay 支付信息

请求示例

{
  "merchantId": "M12345678",
  "orderId": "ORD202412131543011234578",
  "paymentOrderId": "PAY202412131543011234578",
  "subMerId": "",
  "deviceId": "f1c706dc-5424-4904-a482-80af53e5303e",
  "applepayEncData": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

响应参数

• data

参数名	类型	说明
merchantId	String	商户编码
orderId	String	平台交易订单号
paymentOrderId	String	支付订单号
subMerId	String	二级商户编号
orderStatus	String	交易结果状态 pending：交易中 success：交易成功待结算 paid：支付成功可结算 fail：失败 expired：过期

响应示例

{
  "code": 10000,
  "message": "success",
  "data": {
    "merchantId": "M12345678",
    "orderId": "TRD20241213154012000995",
    "paymentOrderId": "PAY20241213154012000993",
    "subMerId": "",
    "orderStatus": "paid"
  }
}