PaymentMethod
Request
Path Parameters
aid
string
必需
EVO Cloud 分配的收单机构号
Header Parameters
Content-type
string
固定值application/json
DateTime
string
请求时间,格式:YYYY-MM-DDThh:mm:ss+hh:00
MsgID
string
建议的值为UUID或GUID来标记此请求,例如2d21a5715c034efb7e0aa383b885fc7a,长度不能超过32个字符
SignType
string
SHA256 或者 SHA512 或 SM2withSM3
Request Body schema
allowNWTokenAuthentication
boolean
默认值: false
表示是否要在获取 Network Token 成功后,对 Token 进行认证,如果送 true 则会在 Network token 获取成功后,对下应答认证链接。
- 使用说明
1. 本字段只有在 networkTokenOnly = true 时生效,其他情况忽略本字段。
2. 目前仅 Mastercard Network Token 支持认证。
authentication
object
认证相关信息
merchantTransInfo
object
必需
商户交易信息
metadata
string(附加信息)<= 512 字符
当请求中上送了本字段, EVO Cloud 将在同步应答、查询以及异步通知中原样返回本字段。
networkTokenOnly
boolean
默认值: false
表示当前接口请求是否仅获取 Network Token
如果为 true,EVO Cloud 将获取并返回 Network Token。
paymentMethod
object
必需
支付方式信息
pspInfo
object
必需
由 psp 分配的交易信息
transInitiator
object
交易发起平台
userInfo
object
关于买家的详细信息
webhook
string(异步通知地址)<= 300 字符
交易在后台成功处理后,推送通知到此地址
Responses
200
POST
/g2/v0/payment/acq/{aid}/evo.e-commerce.paymentMethodTry it
Server
https://hkg-uat-online.everonet.com
Path Parameters
Header Parameters
Request Body Parameters
Request Samples
cURL
curl -i -X POST \
'https://hkg-uat-online.everonet.com/g2/v0/payment/acq/{aid}/evo.e-commerce.paymentMethod' \
-H 'Content-type: application/json' \
-H 'DateTime: string' \
-H 'MsgID: string' \
-H 'SignType: string' \
-d '{
"allowNWTokenAuthentication": false,
"authentication": {
"accountInfo": {
"accountAgeIndicator": "string",
"accountChangeDate": "20170717",
"accountChangeIndicator": "string",
"accountCreationDate": "20170717",
"addCardAttemptsDay": "string",
"deliveryAddressUsageDate": "20170717",
"deliveryAddressUsageIndicator": "string",
"homePhone": {
"countryCode": "string",
"subscriberSections": "string"
},
"mobilePhone": {
"countryCode": "string",
"subscriberSections": "string"
},
"passwordChangeDate": "20170717",
"passwordChangeDateIndicator": "string",
"pastTransactionsDay": "string",
"pastTransactionsYear": "string",
"paymentAccountAge": "20170717",
"paymentAccountIndicator": "string",
"purchasesLast6Months": "string",
"shippingNameIndicator": true,
"suspiciousActivity": true,
"workPhone": {
"countryCode": "string",
"subscriberSections": "string"
}
},
"authenticationType": "string",
"billingAddress": {
"addressLine1": "string",
"addressLine2": "string",
"addressLine3": "string",
"city": "string",
"country": "CHN",
"postalCode": "string",
"stateOrProvince": "string"
},
"browserInfo": {
"acceptHeader": "string",
"colorDepth": "string",
"javaEnabled": true,
"javaScriptEnabled": true,
"language": "en-GB",
"screenHeight": "string",
"screenWidth": "string",
"timeZoneOffset": "-120",
"userAgent": "string"
},
"deliveryAddress": {
"addressLine1": "string",
"addressLine2": "string",
"addressLine3": "string",
"city": "string",
"country": "CHN",
"postalCode": "string",
"stateOrProvince": "string"
},
"merchantRiskIndicator": {
"deliveryAddressIndicator": "string",
"deliveryEmail": "string",
"deliveryTimeframe": "string",
"giftCardAmount": "123",
"giftCardCount": "string",
"giftCardCurrency": "HKD",
"preOrderDate": "20170717",
"preOrderPurchase": true,
"reorderItems": true
},
"returnUrl": "string",
"threeDS": {
"cardholderAccountIdentifier": "string",
"deviceType": "string",
"origin": "string",
"shopperEmail": "string",
"shopperIP": "string",
"threeDSRequestorChallengeInd": "string"
}
},
"merchantTransInfo": {
"merchantOrderReference": "string",
"merchantTransID": "string",
"merchantTransTime": "2017-07-17T13:42:40+01:00"
},
"metadata": "string",
"networkTokenOnly": false,
"paymentMethod": {
"card": {
"cardInfo": {
"cardNumber": "string",
"cvc": "string",
"expiryDate": "string",
"holderName": "string"
},
"cardInfoEncryptMethod": "string",
"cardSource": "string",
"encryptedCardInfo": "string"
},
"isFirstCITTxn": true,
"payerReference": "string",
"recurringProcessingModel": "string",
"tokenValidDays": "string",
"type": "string"
},
"pspInfo": {
"DXS": "string",
"city": "string",
"emailAddress": "string",
"feeProgramIndicator": "string",
"marketplaceIDorSalesOrgID": "string",
"mcc": "string",
"merchantID": "string",
"merchantName": "string",
"merchantVerificationValue": "string",
"nation": "CHN",
"originNation": "SGP",
"paymentFacilitator": "string",
"postCode": "string",
"sponsorCode": "string",
"srcDpaID": "string",
"street": "string",
"subMerchantID": "string",
"telephoneNumber": "string",
"tokenRequesterID": "string",
"transactionCategoryCode": "string"
},
"transInitiator": {
"deviceID": "string",
"deviceType": "string",
"platform": "string"
},
"userInfo": {
"email": "string",
"locale": "string"
},
"webhook": "string"
}'
JavaScript
const aid = 'YOUR_aid_PARAMETER';
fetch(
`https://hkg-uat-online.everonet.com/g2/v0/payment/acq/${aid}/evo.e-commerce.paymentMethod`,
{
method: 'post',
headers: {
'Content-type': 'application/json',
'DateTime': 'string',
'MsgID': 'string',
'SignType': 'string'
},
body: '{
"allowNWTokenAuthentication": false,
"authentication": {
"accountInfo": {
"accountAgeIndicator": "string",
"accountChangeDate": "20170717",
"accountChangeIndicator": "string",
"accountCreationDate": "20170717",
"addCardAttemptsDay": "string",
"deliveryAddressUsageDate": "20170717",
"deliveryAddressUsageIndicator": "string",
"homePhone": {
"countryCode": "string",
"subscriberSections": "string"
},
"mobilePhone": {
"countryCode": "string",
"subscriberSections": "string"
},
"passwordChangeDate": "20170717",
"passwordChangeDateIndicator": "string",
"pastTransactionsDay": "string",
"pastTransactionsYear": "string",
"paymentAccountAge": "20170717",
"paymentAccountIndicator": "string",
"purchasesLast6Months": "string",
"shippingNameIndicator": true,
"suspiciousActivity": true,
"workPhone": {
"countryCode": "string",
"subscriberSections": "string"
}
},
"authenticationType": "string",
"billingAddress": {
"addressLine1": "string",
"addressLine2": "string",
"addressLine3": "string",
"city": "string",
"country": "CHN",
"postalCode": "string",
"stateOrProvince": "string"
},
"browserInfo": {
"acceptHeader": "string",
"colorDepth": "string",
"javaEnabled": true,
"javaScriptEnabled": true,
"language": "en-GB",
"screenHeight": "string",
"screenWidth": "string",
"timeZoneOffset": "-120",
"userAgent": "string"
},
"deliveryAddress": {
"addressLine1": "string",
"addressLine2": "string",
"addressLine3": "string",
"city": "string",
"country": "CHN",
"postalCode": "string",
"stateOrProvince": "string"
},
"merchantRiskIndicator": {
"deliveryAddressIndicator": "string",
"deliveryEmail": "string",
"deliveryTimeframe": "string",
"giftCardAmount": "123",
"giftCardCount": "string",
"giftCardCurrency": "HKD",
"preOrderDate": "20170717",
"preOrderPurchase": true,
"reorderItems": true
},
"returnUrl": "string",
"threeDS": {
"cardholderAccountIdentifier": "string",
"deviceType": "string",
"origin": "string",
"shopperEmail": "string",
"shopperIP": "string",
"threeDSRequestorChallengeInd": "string"
}
},
"merchantTransInfo": {
"merchantOrderReference": "string",
"merchantTransID": "string",
"merchantTransTime": "2017-07-17T13:42:40+01:00"
},
"metadata": "string",
"networkTokenOnly": false,
"paymentMethod": {
"card": {
"cardInfo": {
"cardNumber": "string",
"cvc": "string",
"expiryDate": "string",
"holderName": "string"
},
"cardInfoEncryptMethod": "string",
"cardSource": "string",
"encryptedCardInfo": "string"
},
"isFirstCITTxn": true,
"payerReference": "string",
"recurringProcessingModel": "string",
"tokenValidDays": "string",
"type": "string"
},
"pspInfo": {
"DXS": "string",
"city": "string",
"emailAddress": "string",
"feeProgramIndicator": "string",
"marketplaceIDorSalesOrgID": "string",
"mcc": "string",
"merchantID": "string",
"merchantName": "string",
"merchantVerificationValue": "string",
"nation": "CHN",
"originNation": "SGP",
"paymentFacilitator": "string",
"postCode": "string",
"sponsorCode": "string",
"srcDpaID": "string",
"street": "string",
"subMerchantID": "string",
"telephoneNumber": "string",
"tokenRequesterID": "string",
"transactionCategoryCode": "string"
},
"transInitiator": {
"deviceID": "string",
"deviceType": "string",
"platform": "string"
},
"userInfo": {
"email": "string",
"locale": "string"
},
"webhook": "string"
}'
})
.then(response => response.json())
.then(data => console.log(data));
Response Samples
200
application/json
json