- 集成指南
- 支持的功能（付款方式）
- 设备付款
- Chase Pay 付款
Chase Pay
Chase Pay 是 Chase 提供的一个数字钱包服务，可以使用保存到付款人 Chase 账户的信用卡/借记卡，在任何一台设备上为网络中的付款人提供安全、无缝的在线结账体验。 Chase Pay 是 Mastercard Gateway 支持的设备付款。
此页内容介绍特定于 Chase Pay 的集成详细信息。 建议您在构建 Chase Pay 集成前，先阅读设备付款集成指南。
先决条件
若要接受 Chase Pay 付款：
- 您必须在 Chase 注册。
- 您在网关上的商家配置文件必须由 your payment service provider 启用设备付款。
在您的集成中添加对 Chase Pay 的支持
您可以使用 Direct Payment 将 Chase Pay 集成到您的移动应用内或您网站的结账页。
- 付款确认后，将 Chase Pay 返回的加密付款令牌提交到您的服务器。
- 使用您的私人密钥在服务器上对付款令牌解密。 相关解密步骤，请联系 Chase。
- 在
Authorize/Pay请求或Update Session请求中对应的交易字段内提供已解密付款令牌的密钥。
对于解密的 Chase Pay 付款令牌，支付信息将包含：
Chase Pay JSON 密钥对应的 API 请求字段描述DPAN sourceOfFunds.provided.card.number 为此交易提供资金的卡的令牌。 TokenRequestorID sourceOfFunds.tokenRequestorID 您为此付款向其请求令牌的令牌服务提供商分配给您的唯一标识符。 paymentCryptogram sourceOfFunds.provided.card.devicePayment. onlinePaymentCryptogram 3DSecure 格式的密文。 eciIndicator sourceOfFunds.provided.card.devicePayment.eciIndicator 依据 3DSecure 规范的 ECI 指示器 - 除上述字段外，将这些字段包含在 Authorize/Pay 请求中，并提交到网关。
- transaction.source=INTERNET
- order.walletProvider=CHASE_PAY
- device.mobilePhoneModel： （可选）用于发起付款的移动设备的识别码。
- sourceOfFunds.provided.card.expiry
- order.amount
- order.currency
- posTerminal.location: 您可以指定
PAYER_TERMINAL_OFF_PREMISES或PAYER_TERMINAL_ON_PREMISES。 如果您未提供值，将使用PAYER_TERMINAL_OFF_PREMISES。
请求示例
下面是付款令牌由网关解密的 REST 中的 Authorization 请求示例。
| URL | 'https://test-anb.mtf.gateway.mastercard.com/api/rest/version/71/merchant/MADA_DMS_AU/order/169133315/transaction/884896907' |
| HTTP 方法 | PUT |
| 标头 | 'Authorization: Basic bWVyY2hhbnQuTUFEQV9ETVNfQVU6M2RjYTQ2YTU1ODYwNDlmMjhhM2FmZGJmZDEwMGNmNWQ=' |
'{
"apiOperation": "AUTHORIZE",
"order": {
"amount": "100",
"currency": "USD",
"walletProvider": "CHASE_PAY"
},
"sourceOfFunds": {
"provided": {
"card": {
"expiry": {
"month": "05",
"year": "17"
},
"number": "4444333322221111",
"devicePayment": {
"cryptogramFormat": "3DSECURE",
"onlinePaymentCryptogram": "gIG4FrSFGCg4iYqLjI2Oj5CRkpM=",
"eciIndicator": "05"
}
}
},
"type": "CARD",
"tokenRequestorID": "12345678901"
},
"transaction": {
"source": "INTERNET"
}
}'
响应示例
{
"authorizationResponse": {
"commercialCard": "!01",
"commercialCardIndicator": "0",
"date": "0314",
"posData": "1025104006600",
"posEntryMode": "812",
"processingCode": "003000",
"responseCode": "00",
"returnAci": "Y",
"stan": "44427",
"time": "104520"
},
"gatewayEntryPoint": "WEB_SERVICES_API",
"merchant": "MADA_DMS_AU",
"order": {
"amount": 100.00,
"authenticationStatus": "AUTHENTICATION_NOT_IN_EFFECT",
"certainty": "FINAL",
"chargeback": {
"amount": 0,
"currency": "USD"
},
"creationTime": "2023-03-14T10:45:20.127Z",
"currency": "USD",
"id": "169133315",
"lastUpdatedTime": "2023-03-14T10:45:20.671Z",
"merchantAmount": 100.00,
"merchantCategoryCode": "1234",
"merchantCurrency": "USD",
"status": "AUTHORIZED",
"totalAuthorizedAmount": 100.00,
"totalCapturedAmount": 0.00,
"totalDisbursedAmount": 0.00,
"totalRefundedAmount": 0.00,
"walletProvider": "CHASE_PAY"
},
"response": {
"acquirerCode": "00",
"acquirerMessage": "Approved",
"gatewayCode": "APPROVED",
"gatewayRecommendation": "NO_ACTION"
},
"result": "SUCCESS",
"sourceOfFunds": {
"provided": {
"card": {
"brand": "VISA",
"devicePayment": {
"cryptogramFormat": "3DSECURE"
},
"deviceSpecificExpiry": {
"month": "5",
"year": "17"
},
"deviceSpecificNumber": "444433xxxxxx1111",
"fundingMethod": "UNKNOWN",
"number": "xxxxxxxxxxxxxxxx",
"scheme": "VISA",
"storedOnFile": "NOT_STORED"
}
},
"tokenRequestorID": "12345678901",
"type": "CARD"
},
"timeOfLastUpdate": "2023-03-14T10:45:20.671Z",
"timeOfRecord": "2023-03-14T10:45:20.331Z",
"transaction": {
"acquirer": {
"batch": 20230314,
"date": "0314",
"id": "SYSTEST_ACQ_S2I",
"merchantId": "12345678"
},
"amount": 100.00,
"authenticationStatus": "AUTHENTICATION_NOT_IN_EFFECT",
"authorizationCode": "112233",
"currency": "USD",
"id": "884896907",
"receipt": "307310044427",
"source": "INTERNET",
"stan": "44427",
"terminal": "1111",
"type": "AUTHORIZATION"
},
"version": "71"
}