Credit/Debit Card
Credit/Debit Card：支持信用卡和借记卡交易，包括Visa、MasterCard、Discover、American Express、Diner's Club、JCB和Maestro卡。
支付方式属性
| 属性 | 内容 |
|---|---|
| 可用国家代码 | 美国 (US) |
| 消费者货币 | 美元 (USD) |
| 处理货币 | 美元 (USD) |
| 结算货币 | 美元 (USD) |
| 类型 I | 信用卡及借记卡（Cards） |
| 类型 II | cardsus |
| 最小交易金额 | USD：1 |
| 最大交易金额 | USD：10,000 |
| 会话超时 | 1 小时，取决于流程 |
| 退款 | 支持全额退款、部分退款和多次部分退款 |
| 退款有效期 | 360 天 |
| 拒付 | 180 天 |
当国家代码与处理货币不一致时，FuturePay会按照国际卡费率处理交易。
交易流程
- 在线付款如需3DS验证，需使用安全公钥(联系工作人员获取)提前加载：Gateway.js
- 在线结账时，消费者选择 Visa 或 Mastercard 作为首选支付方式；
- 消费者输入卡片详细信息；
- 消费者输入通过短信或其他方式发送的授权码验证交易；
- 确认付款.
# 请使用测试卡信息验证
集成
Gateway.js加载3DS示例代码
<html>
<body>
<script src="https://secure.nmi.com/js/v1/Gateway.js"></script>
<script>
// Initialize Gateway.js
const gateway = Gateway.create('collect_checkout_0000000000000000000000');
// Initialize the ThreeDSService
const threeDS = gateway.get3DSecure();
// Create a 3DS Frame
// This will start out 0px x 0px during fingerprinting.
// If the customer is prompted to complete a challenge, it will resize automatically.
const options = {
cardNumber: "4111111111111111",
cardExpMonth: "01",
cardExpYear: "2024",
currency: 'USD',
amount: '10.00',
email: '[email protected]',
phone: '8008675309',
city: 'New York',
state: 'NY',
address1: '123 First St.',
country: 'US',
firstName: 'Jane',
lastName: 'Doe',
postalCode: '60001'
};
const threeDSecureInterface = threeDS.createUI(options);
// Mount the threeDSecureInterface to the DOM
// This begins the collection of 3DS data.
threeDSecureInterface.start('body');
// Listen for the threeDSecureInterface to ask the user for a password
threeDSecureInterface.on('challenge', function(e) {
console.log('Challenged');
});
// Listen for the threeDSecureInterface to provide all the needed 3DS data
threeDSecureInterface.on('complete', function(e) {
fetch('direct-post-back-end.php', {
method: 'POST',
body: JSON.stringify({
...options,
cavv: e.cavv,
xid: e.xid,
eci: e.eci,
cardHolderAuth: e.cardHolderAuth,
threeDsVersion: e.threeDsVersion,
directoryServerId: e.directoryServerId,
cardHolderInfo: e.cardHolderInfo,
})
})
});
// Listen for the threeDSecureInterface to indicate that the customer
// has failed to authenticate
threeDSecureInterface.on('failure', function(e) {
console.log('failure');
console.log(e);
});
// Listen for any errors that might occur.
gateway.on('error', function (e) {
console.error(e);
})
</script>
</body>
</html>交易调用输入
{
"amount": {
"currency": "KES",
"value": 100
},
"countryCode": "KE",
"paymentMethod": {
"bankAccountNumber": "4000000000002701",
"cvc": "1212",
"expiryMonth": "10",
"expiryYear": "25",
"firstName": "123123",
"holderName": "123123 123123",
"lastName": "123123",
"shopperEmail": "[email protected]",
"telephoneNumber": "5513762379010",
"type": "cardsus"
},
"threeDS2RequestData": {
//以下内容是通过调用Gateway.js生成3DS数据，需将原文带入请求参数
"cardholderAuth": "verified",
"cavv": "AJkBBkhgQQAAAE4gSEJydQAAAAA=",
"threeDsVersion": "2.2.0",
"xid": "0"
},
"reference": "8C2FAD7F7CD54A259769F51FD9AE88B3-3"
}交易调用输出
{
"code": "0",
"data": {
"amount": {
"currency": "USD",
"value": 100
},
"merchantReference": "24120307251378-339-1",
"pspReference": "1863851461092442112",
"resultCode": "SUCCEED"
},
"msg": "success",
"serverTime": 1733211799270,
"success": true
}Updated 15 days ago