PaymentMethod

POST

/g2/v1/payment/mer/{sid}/paymentMethod

Request

Path Params

Header Params

Body Params application/json

Example

{
    "merchantTransInfo": {
        "merchantTransID": "string",
        "merchantOrderReference": "string",
        "merchantTransTime": "2019-08-24T14:15:22.123Z"
    },
    "storeInfo": {
        "mcc": "stri"
    },
    "transAmount": {
        "currency": "str"
    },
    "allowAuthentication": true,
    "networkTokenOnly": true,
    "returnURL": "string",
    "paymentMethod": {
        "recurringProcessingModel": "Subscription",
        "isFirstCITTxn": true,
        "type": "card",
        "accountUpdateIndicator": "Y",
        "card": {
            "encryptedCardInfo": "string",
            "cardInfo": {
                "cardNumber": "string",
                "expiryDate": "stri",
                "cvc": "stri",
                "holderName": "string"
            },
            "tokenValidDays": "1~365",
            "vaultID": "string"
        },
        "e-wallet": {
            "paymentBrand": "Alipay",
            "vaultID": "string",
            "planID": "string",
            "subOpenID": "string"
        },
        "buyNowPayLater": {
            "paymentBrand": "string",
            "vaultID": "string"
        },
        "googlePay": {
            "encryptedData": "string",
            "paymentBrand": "Visa",
            "tokenize": true,
            "vaultID": "string",
            "tokenValidDays": "1~365"
        },
        "merchantToken": {
            "value": "string"
        }
    },
    "authentication": {
        "type": "threeDSPage",
        "merchantRiskIndicator": {},
        "threeDS": {
            "threeDSRequestorChallengeInd": "01"
        }
    },
    "transInitiator": {
        "platform": "WEB",
        "deviceType": "Android",
        "deviceID": "string",
        "userRegion": "str",
        "osVersion": "string",
        "userCreateIP": "str",
        "browserInfo": {
            "acceptHeader": "string",
            "colorDepth": "st",
            "javaEnabled": true,
            "language": "string",
            "screenHeight": "string",
            "screenWidth": "string",
            "timeZoneOffset": "strin",
            "userAgent": "string"
        },
        "terminalID": "string"
    },
    "userInfo": {
        "nameEn": {
            "familyName": "string",
            "givenName": "string"
        },
        "nameLocal": {
            "familyName": "string",
            "givenName": "string"
        },
        "nameZh": {
            "familyName": "string",
            "givenName": "string"
        },
        "homePhone": {
            "countryCode": "str",
            "subscriberSections": "string"
        },
        "mobilePhone": {
            "countryCode": "str",
            "subscriberSections": "string"
        },
        "workPhone": {
            "countryCode": "str",
            "subscriberSections": "string"
        },
        "email": "string",
        "reference": "string",
        "locale": "strin",
        "accountInfo": {
            "accountAgeIndicator": "notApplicable",
            "accountChangeDate": "string",
            "accountChangeIndicator": "thisTransaction",
            "accountCreationDate": "string",
            "passwordChangeDate": "string",
            "passwordChangeDateIndicator": "notApplicable",
            "purchasesLast6Months": "stri",
            "addCardAttemptsDay": "str",
            "pastTransactionsDay": "str",
            "pastTransactionsYear": "str",
            "paymentAccountAge": "string",
            "paymentAccountIndicator": "notApplicable",
            "deliveryAddressUsageDate": "string",
            "deliveryAddressUsageIndicator": "thisTransaction",
            "shippingNameIndicator": true,
            "suspiciousActivity": true
        },
        "deliveryAddress": {
            "city": "string",
            "country": "str",
            "addressLine1": "string",
            "addressLine2": "string",
            "addressLine3": "string",
            "postalCode": "string",
            "stateOrProvince": "str"
        },
        "billingAddress": {
            "city": "string",
            "country": "str",
            "addressLine1": "string",
            "addressLine2": "string",
            "addressLine3": "string",
            "postalCode": "string",
            "stateOrProvince": "str"
        }
    },
    "subMerchantInfo": {
        "merchantID": "string",
        "descriptor": "string"
    },
    "webhook": "string",
    "metadata": "string"
}

Responses

🟢200成功

application/json

Headers

Bodyapplication/json

Example

{
    "result": {
        "code": "string",
        "message": "string",
        "pspResponseCode": "string",
        "pspMessage": "string"
    },
    "action": {
        "type": "threeDSRedirect",
        "threeDSData": {
            "url": "string",
            "method": "GET",
            "parameter": {
                "PaReq": "string",
                "MD": "string",
                "TermUrl": "string",
                "creq": "string",
                "threeDSMethodData": "string"
            }
        },
        "redirectData": {
            "url": "string",
            "method": "GET"
        },
        "walletData": {
            "paymentString": "string"
        }
    },
    "paymentMethod": {
        "accountUpdateIndicator": "Y",
        "paymentAccountReference": "string",
        "status": "Verifying",
        "failureCode": "string",
        "failureReason": "string",
        "merchantTransInfo": {
            "merchantTransID": "string",
            "merchantOrderReference": "string",
            "merchantTransTime": "2019-08-24T14:15:22.123Z"
        },
        "card": {
            "first6No": "string",
            "last4No": "stri",
            "paymentBrand": "string",
            "fundingType": "credit",
            "holderName": "string",
            "issuingBank": "string",
            "issuingCountry": "str",
            "issuerCountry": "str",
            "isCommercial": true
        },
        "token": {
            "value": "string",
            "expiryDate": "2019-08-24T14:15:22.123Z",
            "userReference": "string",
            "vaultID": "string",
            "fingerprint": "string",
            "createTime": "2019-08-24T14:15:22.123Z",
            "updateTime": "2019-08-24T14:15:22.123Z",
            "status": "disabled",
            "first6No": "string",
            "last4No": "stri"
        },
        "networkToken": {
            "status": "enabled",
            "supportDeviceBinding": true,
            "value": "string",
            "paymentBrand": "Visa",
            "tokenID": "string",
            "first6No": "string",
            "last4No": "stri",
            "expiryDate": "stri",
            "paymentAccountReference": "string",
            "tokenReferenceID": "string"
        },
        "recurringReference": "string",
        "merchantToken": {
            "value": "string"
        }
    },
    "authentication": {
        "type": "threeDSPage",
        "threeDS": {
            "mpiData": {
                "status": "Y",
                "transStatusReason": "st",
                "cardholderInfo": "string",
                "cavv": "string",
                "eci": "st",
                "dsTransID": "string",
                "threeDSVersion": "string"
            },
            "isFrictionless": "Y"
        }
    },
    "metadata": "string"
}

API Rules

PaymentMethod