--- title: "paymentMethod" method: GET path: "/paymentMethod?merchantTransID={merchantTransInfo_merchantTransID}" --- # paymentMethod `GET /paymentMethod?merchantTransID={merchantTransInfo_merchantTransID}` ## Path parameters - `merchantTransInfo_merchantTransID` string, required ## Query parameters - `merchantTransID` string - `userReference` string - `token` string - `cardBIN` string - `paymentBrand` string - `currency` string - `tokenize` boolean - `amount` string ## Headers - `Authorization` string, required - `Content-type` string, required - `DateTime` string, required - `KeyID` string, required - `MsgID` string - `SignType` string, required ## Request body - object ## Response `200` - object - `result` object, required — The result information for the transaction processed - Usage Instruction 1. Used in the response of PaymentMethod, Payment, Capture, Cancel and Refund - `code` string, required — This is the code of result from Evonet about the transaction processed - Value defined Refer to . - Usage Instruction 1. Field Type: String(8) - `message` string, required — This is the description about the code of result - Value defined Refer to . - Usage Instruction 1. Field Type: String(1024) - `category` 'M' | 'N' | 'E' | 'S' | 'H' | 'R' — The category of the response code. - `pspResponseCode` string — This is the Response code from the PSP. - Usage Instruction 1. If the PSP returns a response code for the transaction, Evonet will forward to merchant in this field 2. Field Type: String(1024) - `pspMessage` string — This is the Response code from the PSP. - Usage Instruction 1. If the PSP returns a response code for the transaction, Evonet will forward to merchant in this field 2. Field Type: String(1024) - `action` object — This object is to define the next step action for merchant or Evonet, with the related data when performing the action - `type` 'threeDSRedirect' | 'threeDSIdentify' | 'threeDSChallenge' | 'inputMobilePhone' | 'inputOTP' | 'redirectUser' | 'redirectInIframe' | 'presentQRCode' | 'invokeWallet' | 'resendOTP' | 'presentEcontext' | 'promptUser' | 'completed', required — This field includes the action type for merchant or Evonet to perform: The description of each value, please refer to Appendix 8.9 Action Type - Usage Instruction Field Type: String(32) - `threeDSData` object — This object is the data when performing the action when action.type=threeDSRedirect, threeDSIdentify or threeDSChallenge. - `url` string — The URL address. Merchant redirects the user to this URL by the method specified in action.threeDSData.method. -Usage Instruction 1. When performing 3DS authentication in threeDSPage mode, this field in the POST PaymentMethod or POST Payment response message, with action.type=threeDSRedirect, specifies the Evonet hosted authentication page, which is a blank page that completes the complex authentication process with different card schemes. 2. When performing 3DS authentication in threeDSIntegrator mode, this field in the POST PaymentMethod or POST Payment response message, with action.type=threeDSRedirect, threeDSIdentify or threeDSChallenge, specifies the card scheme or issuer authentication page. Field Type: String(2048) - `method` 'GET' | 'POST' — The HTTP method when performing the redirection. - Usage Type Field Type: String(8) - `parameter` object — The 3DS redirection parameter returned by Evonet. Merchant needs to submit the parameter(s) in this object when redirect to action.threeDSData.url. - `PaReq` string — The 3DS request data for the issuer. -Usage Instruction When performing 3DS authentication in threeDSIntegrator mode, this field in the POST PaymentMethod or POST Payment response message, with action.type=threeDSRedirect, specifies the required data that merchant needs to POST as a form element to the 3DS authentication page. Field Type: String(30000) - `MD` string — The payment session identifier returned by the card issuer. -Usage Instruction When performing 3DS authentication in threeDSIntegrator mode, this field in the POST PaymentMethod or POST Payment response message, with action.type=threeDSRedirect, specifies the required data that merchant needs to POST as a form element to the 3DS authentication page. Field Type: String(300) - `TermUrl` string — After completing 3DS authentication on the card issuer site, the user is redirected back to the merchant site. This URL value specifies which merchant site page the user goes back to. -Usage Instruction When performing 3DS authentication in threeDSIntegrator mode, this field in the POST PaymentMethod or POST Payment response message, with action.type=threeDSRedirect, specifies the required data that merchant needs to POST as a form element to the 3DS authentication page. Field Type: String(300) - `creq` string — The 3DS Challenge request data for the issuer. -Usage Instruction When performing 3DS authentication in threeDSIntegrator mode, this field in the PUT PaymentMethod or PUT Payment response message, with action.type=threeDSChallenge, specifies the required data that merchant needs to POST as a form element to the 3DS authentication page. Field Type: String(30000) - `threeDSMethodData` string — The 3DS Method Data. The base64 data need the user's bowser sends to ACS URL(action.threeDS.url). -Usage Instruction When performing 3DS authentication in threeDSIntegrator mode, this field in the POST PaymentMethod or POST Payment response message, with action.type=threeDSIdentify, specifies the required data that merchant needs to POST as a form element to the ACS URL. Field Type: String(2048) - `redirectData` object — This object is the data when performing the action when action.type = redirectUser or redirectInIframe. - `url` string, required — The URL to redirect to. Merchant redirects the user to this URL by the method specified in action.redirectData.method. -Usage Instruction 1. When performing the tokenization with Alipay, this field in the POST PaymentMethod response message, with action.type=redirectUser, specifies the Alipay pre-contract page for user to sign the agreement with Alipay. 2. When performing the payment with E-Wallets including (a) Alipay, Alipay+ and Jkopay on PC WEB, (b) Alipay, Alipay+, Alipay HK, WeChat Pay and Jkopay on Mobile WAP, and (c) WeChat Pay in Official Account, this field in the POST Payment response message, with action.type=redirectUser, specifies the wallet payment page for user to complete the payment. Same as when performing the payment with SecurePay for UnionPay on PC WEB, Mobile WAP and wallet APP. 3. When performing the payment with E-Wallet on PC WEB using Alipay HK, this field in the POST Payment response message, with action.type=redirectInIframe, specifies the wallet QR code page for user to scan and pay. Please note that instead of a simple redirection for the whole page, merchant need to render an iframe on its payment page and perform the redirection in the iframe to show the wallet QR code to guide user to pay. Note: If your Alipay merchant account is Alipay HK account, when performing the payment with E-Wallet on PC WEB using Alipay, also need redirect in the iframe. Field Type: String(4096) - `method` 'GET' | 'POST' — The HTTP method when performing the redirection. - Usage Instruction Field Type: String(8) - `parameter` string — The redirection parameter returned by Evonet. -Usage Instruction 1. When method = POST, merchant needs to send this field to redirectData.url with the HTTP POST. Field Type: String(4096) - `walletData` object — This object is the data when performing the action with action.type=invokeWallet. - `paymentString` string, required — The parameters required to invoke the wallet APP. Merchant invokes the wallet APP by a redirection with this parameter. -Usage Instruction 1. When performing the tokenization with WeChat Pay in WeChat Mini-Program, this field in the POST PaymentMethod response message, with action.type=invokeWallet, specifies the parameters required to invoke WeChat Pay pre-contract page for user to sign the agreement with WeChat Pay. 2. When performing the payment with WeChat Mini-Program or Alipay, Alipay HK or WeChat Pay in their wallet APP, this field in the POST Payment response message, with action.type=invokeWallet, specifies the parameters required to invoke the wallet APP payment page for user to complete the payment. Field Type: String(20000) - `paymentMethod` object — This field includes the Payment Method information, including Payment Method selected by User for Payment, and the Payment Method supported by the merchant - Usage Instruction 1. For GET PaymentMethod response, If merchant sends merchantTransID in GET PaymentMethod request. Evonet will return this object. - `status` 'verify_pending' | 'tokenized_pending' | 'tokenized' | 'verify_declined' | 'tokenized_declined', required — The status of Original PaymentMethod transaction - Usage Instruction 1. Field Type: String(20) - `failureCode` string — Error code returned for the PaymentMethod. - Value defined Refer to . - Usage Instruction 1. Only returned when the paymentMethod.status=Failed 2. Field Type: String(8) - `failureReason` string — Error message returned for the PaymentMethod. - Value defined Refer to . - Usage Instruction 1. Only returned when the paymentMethod.status=Failed 2. Field Type: String(1024) - `merchantTransInfo` object, required — This is the information of merchantTransInfo from the request of the initial PaymentMethod transaction - `merchantTransID` string, required — This is the merchantTransID from the initial PaymentMethod transaction - Usage Instruction 1. Field Type: String(32) - `merchantOrderReference` string — This is the merchantOrderReference from the initial PaymentMethod transaction - Usage Instruction 1. Field Type: String(32) - `merchantTransTime` string, date-time, required — This is the merchantTransTime from the initial PaymentMethod transaction - Usage Instruction 1. Format: ISO 8601 YYYY-MM-DDThh:mm:ssTZD 2. Sample: 2017-07-17T13:42:40+01:00 - `card` object — This field is to send card related information for this transaction -Usage Instruction: 1. For POST Payment or POST PaymentMethod. If paymentMethod.type = card, the field must be present 2. For PUT PaymentMethod. Merchant may send this field to update the card information corresponding to the token and the profile of the token. 3. Evonet may include this object in response 4. For POST Payment or POST PaymentMethod response. If paymentMethod.type=GooglePay & The paymentMethod.encryptedData is a card that consists of PAN, the field will be present. - `first6No` string, required — The first 6 digits of the card number - Usage Instruction 1. This field is used in response from Evonet 2.For POST Payment or POST PaymentMethod response. If paymentMethod.type=GooglePay & The paymentMethod.encryptedData is a card that consists of PAN, the field will be present. 3. Field Type: String(6) - `last4No` string, required — The last 4 digits of the card number - Usage Instruction 1. This field is used in response from Evonet 2.For POST Payment or POST PaymentMethod response. If paymentMethod.type=GooglePay & The paymentMethod.encryptedData is a card that consists of PAN, the field will be present. 3. Field Type: String(4) - `paymentBrand` string — This is used to indicate the card scheme which the card belongs to - Value defined The accepted values of this field, please refer to card paymentMethod type of the Appendix 8.8 payment brands - Usage Instruction: 1. This is used in response from Evonet 2.For POST Payment or POST PaymentMethod response. If paymentMethod.type=GooglePay & The paymentMethod.encryptedData is a card that consists of PAN, the field will be present. 3. Field Type: String(32) - `fundingType` 'credit' | 'debit' | 'prepaid' — This is used to indicate the type of the card - Usage Instruction 1. This field is used in response from Evonet 2. Field Type: String(32) - `holderName` string — The cardholder name - Usage Instruction 1. This field is used in the response from Evonet 2. Field Type: String(50) - `issuingBank` string — The name of Issuing Bank - Usage Instruction 1. This field is used in response from Evonet 2. Field Type: String(16) - `issuingCountry` string — The card issuing country. - Usage Instruction 1. This field is used in response from Evonet 2. The three-character country code as defined in ISO-3166-1 alpha-3. For example, SGP. 3. Field Type: String(3) - `issuerCountry` string — The cardholder's country. - Usage Instruction 1. This field is used in response from Evonet 2. The three-character country code as defined in ISO-3166-1 alpha-3. For example, SGP. 3. Field Type: String(3) - `isCommercial` boolean — This is used to response whether the card is a business card. -Value defined true: this card is a business card false: this card is not a business card - Usage Instruction 1. This field is used in response from Evonet 2. Field Type: Boolean - `e-wallet` object — This is used to send e-wallet related Information for this transaction - Usage Instruction 1. For POST payment or PaymentMethod request, if paymentMethod.type = 'e-wallet', the field must be present 2. For PUT PaymentMethod. Merchant may send this field to update the profile of the token. 3. Evonet may include this object in response - `paymentBrand` string, required — This is to indicate the payment brand of E-Wallet. - Value defined The accepted values of this field, please refer to e-wallet paymentMethod type of the Appendix 8.8 payment brands - Usage Instruction 1. For POST PaymentMethod request: only Alipay, Alipayplus, AlipayHK, Boost, DANA, GCash, Kakao_Pay, Rabbit_LINE_Pay, TNG, TrueMoney_Wallet, Maya, Naver_Pay, GrabPay_SGP and WeChat_Pay are applied 2. For POST Payment request: all values are applied 3. All values are applied in response from Evonet 4. This field is optional when transInitiator.inStorePaymentScenario=CPM 5. Field Type: String(32) - `walletName` 'TrueMoney_Wallet' | 'AlipayHK' | 'TNG' | 'Alipay' | 'GCash' | 'DANA' | 'Kakao_Pay' | 'Rabbit_LINE_Pay' | 'Boost' | 'CONNECT_WALLET' | 'Naver_Pay' | 'Maya' | 'GrabPay_SGP' — This is to indicate the child wallet name. - Value defined TrueMoney_Wallet: Means TrueMoney Wallet AlipayHK: Means AlipayHK TNG: Means Touch 'n Go eWallet Alipay: Means Alipay CN GCash: Means GCash Wallet DANA: Means DANA Wallet Kakao_Pay: Means KakaoPay Wallet Rabbit_LINE_Pay: Means Rabbit LINE Pay Boost: Means the Boost eWallet CONNECT_WALLET: Means Alipay+ wallets (Only in test environment) Naver_Pay: Means NaverPay Wallet Maya: Means Maya Wallet GrabPay_SGP: Means GrabPay_SGP Wallet - Usage Instruction 1. For PaymentMethod, this file will be returned when create Alipay+ token. 2. Field Type: String(64) - `planID` string — This is the ID assigned by WeChat, when merchant obtained the license for some special service like Recurring Payment from WeChat - Usage Instruction 1. Merchant shall obtain the license and the ID from WeChat before starting the service 2. For POST PaymentMethod, this field must be present when paymentMethod.e-wallet.paymentBrand=WeChat_Pay 3. Evonet may include this field in response 4. Field Type: String(1024) - `contractID` string — This is the filed assigned by WeChat, after user completed sign contract with WeChat pay in mini program. - Usage Instruction 1. This filed is obtained in WeChat mini program 2. This filed is used to send to Evonet in PUT PaymentMethod to submit additional tokenization info. 3. Evonet may include this field in response 4. Field Type: String(1024) - `subOpenID` string — This is the user ID for a User in merchant's Mini-Program of WeChat - Usage Instruction 1. After user logins in merchant's Mini-Program of WeChat, merchant could have this ID for user 2. For POST Payment, it is mandatory when the paymentMethod.e-wallet.paymentBrand = WeChat_Pay, and transInitiator.platform=MINI. 3. For POST PaymentMethod, this is mandatory when paymentMethod.e-wallet.paymetBrand=WeChat_Pay 4. Evonet may include this field in response 5. Field Type: String(64) - `consumerId` string — This is the customer ID obtained from the e-wallet - Usage Instruction 1. This is information from e-wallet, and will be included in the response from Evonet 2. Field Type: String(64) - `consumerAccount` string — This is the customer account obtained from the e-wallet - Usage Instruction 1. This is information from e-wallet, and will be included in the response from Evonet 2. Field Type: String(64) - `token` object — This is used to send token related Information for this transaction - Usage Instruction 1. For POST payment or PaymentMethod request, if paymentMethod.type = token, the field must be sent 2. For POST Payment or POST PaymentMethod response. If paymentMethod.type=GooglePay & The paymentMethod.encryptedData is a tokenized card that consist of device PAN and cryptograms, the field will be present. 3. Evonet may include this field in response - `value` string, required — The token value. - Usage Instruction 1. For POST Payment request, this must be sent when paymentMethod.type = token 2. For POST Payment response, this is used in response from Evonet 3. For PUT PaymentMethod and PUT Payment, this is used in response from Evonet 4.For POST Payment or POST PaymentMethod response. If paymentMethod.type=GooglePay & The paymentMethod.encryptedData is a tokenized card that consist of device PAN and cryptograms, the field will be set as masked device PAN. 5.For POST Payment or POST PaymentMethod response. If paymentMethod.type=GooglePay & paymentMethod.GooglePay.tokenize=true&The paymentMethod.encryptedData is a tokenized card that consist of device PAN and cryptograms, the field will be set as getewayToken value. 6. Field Type: String(64) - `expiryDate` string, date-time — This is the token expiration date and time -Usage Instruction 1. Evonet may include this field in response 2. If the token permanent valid, this filed will be not return. 3. Format: ISO 8601 YYYY-MM-DDThh:mm:ssTZD 4. Sample: 2017-07-17T13:42:40+01:00. 5. Field Type: Datetime - `userReference` string — The User ID obtained or assigned by merchant, and used for merchant reference - Usage Instruction 1. Evonet may include this field in response 2. The value of this field is same as userInfo.reference in your POST request. 3. Field Type: String(64) - `vaultID` string — The group ID which the token belongs to. This token is unique under same vault ID - Usage Instruction: 1. This ID is assigned in Evonet, and will be provided to customer before integration. 2. Evonet may include this field in response 3. Field Type: String(36) - `fingerprint` string — The token's fingerprint. - Usage Instruction 1. Evonet may include this field in response 2. Field Type: String(64) - `createTime` string, date-time — The token's created Datetime. -Usage Instruction 1. Format: ISO 8601 YYYY-MM-DDThh:mm:ssTZD 2. Sample: 2017-07-17T13:42:40+01:00. 3. Evonet may include this field in response 4. Field Type: Datetime - `updateTime` string, date-time — The token's last updated Datetime. -Usage Instruction 1. Format: ISO 8601 YYYY-MM-DDThh:mm:ssTZD 2. Sample: 2017-07-17T13:42:40+01:00. 3. Evonet may include this field in response 4. Field Type: Datetime - `status` 'disabled' | 'enabled' | 'expired', required — The status of token - Usage Instruction 1. Evonet may include this field in response 2. Field Type: String(20) - `first6No` string — The first 6 digits of the tokenized cards that consist of device PAN. - Usage Instruction 1. For POST Payment or POST PaymentMethod response. If paymentMethod.type = Google Pay&paymentMethod.GooglePay.tokenize=true&The paymentMethod.encryptedData is a tokenized card that consist of device PAN and cryptograms, the field will be present. 2. Field Type: String(6). - `last4No` string — The last 4 digits of the tokenized cards consist of device PAN. - Usage Instruction 1. For POST Payment or POST PaymentMethod response. If paymentMethod.type = Google Pay&paymentMethod.GooglePay.tokenize=true&The paymentMethod.encryptedData is a tokenized card that consist of device PAN and cryptograms, the field will be present. 2. Field Type: String(4). - `networkToken` object — This object is used to send network token related Information for this transaction - Usage Instruction 1. For POST PaymentMethod response, if the request generated a network token, the field will be present. - `status` 'enabled' | 'suspended' | 'disable', required — The status of Network Token - Usage Instruction 1. Field Type: String(32) - `supportDeviceBinding` boolean, required — Does current network token support device binding? - Value definition true: support false: unsupport -Uasge Instruction If current network token support device binding, you can use PUT PaymentMethod to continue the binding. - `tokenID` string, required — The unique ID of the network token assigned by card scheme - Usage Instruction 1. Evonet may include this field in response. 2. Field Type: String(64) - `first6No` string, required — The first 6 digits of the network token - Usage Instruction 1. This field is used in response from Evonet 2. Field Type: String(6) - `last4No` string, required — The last 4 digits of the network token - Usage Instruction 1. This field is used in response from Evonet 2. Field Type: String(4) - `expiryDate` string, required — The expiration date of the network token -Usage Instruction 1. Format: MMYY - `paymentAccountReference` string — Payment Account Reference (PAR) if available for this payment instrument. - Usage Instruction 1. This field is used in response from Evonet 2. Field Type: String(64) - `tokenReferenceID` string — It is a unique ID associated with a single token. - Usage Instruction 1. This field is used in response from Evonet 2. Field Type: String(64) - `recurringReference` string — The recurringReference that uniquely identifies the recurring transaction. Merchant will needs this to make future payments for the user. - Usage Instruction 1. For POST Payment response, PUT Payment response GET Payment response, Payment Notification , POST PaymentMethod response, PUT PaymentMethod response, GET PaymentMethod response and PaymentMethod Notification, it is generated by Evonet. 2. For POST Payment request, it is present for future payments. 3. Field Type: String(64) - `accountUpdateIndicator` 'Y' | 'N' — Account Update Indicator - Usage Instruction 1. This field is suitable for the paymentBrand=Visa - `paymentMethodList` object[] — This array includes the Payment Method information, including Payment Method(s) supported by the user. - Usage Instruction 1. For GET PaymentMethod or DELETE PaymentMethod response, Evonet will use this array to return the Payment Method information of the user. 2. For GET PaymentMethod response, If merchant sends userReference or token in GET PaymentMethod request. Evonet will return this object. - `token` object — This is used to send token related Information for user. - Usage Instruction 1. For GET PaymentMethod response, Evonet may include this field in response. 2. For GET PaymentMethod response, if the merchant uses userReference to query the Payment Method information of the user, and there are more than one Payment Method of the user, Evonet will return multiple token objects in array format. - `value` string, required — The token value. - Usage Instruction 1. For POST Payment request, this must be sent when paymentMethod.type = token 2. For POST Payment response, this is used in response from Evonet 3. For PUT PaymentMethod and PUT Payment, this is used in response from Evonet 4.For POST Payment or POST PaymentMethod response. If paymentMethod.type=GooglePay & The paymentMethod.encryptedData is a tokenized card that consist of device PAN and cryptograms, the field will be set as masked device PAN. 5.For POST Payment or POST PaymentMethod response. If paymentMethod.type=GooglePay & paymentMethod.GooglePay.tokenize=true&The paymentMethod.encryptedData is a tokenized card that consist of device PAN and cryptograms, the field will be set as getewayToken value. 6. Field Type: String(64) - `expiryDate` string, date-time — This is the token expiration date and time -Usage Instruction 1. Evonet may include this field in response 2. If the token permanent valid, this filed will be not return. 3. Format: ISO 8601 YYYY-MM-DDThh:mm:ssTZD 4. Sample: 2017-07-17T13:42:40+01:00. 5. Field Type: Datetime - `userReference` string — The User ID obtained or assigned by merchant, and used for merchant reference - Usage Instruction 1. Evonet may include this field in response 2. The value of this field is same as userInfo.reference in your POST request. 3. Field Type: String(64) - `vaultID` string — The group ID which the token belongs to. This token is unique under same vault ID - Usage Instruction: 1. This ID is assigned in Evonet, and will be provided to customer before integration. 2. Evonet may include this field in response 3. Field Type: String(36) - `fingerprint` string — The token's fingerprint. - Usage Instruction 1. Evonet may include this field in response 2. Field Type: String(64) - `createTime` string, date-time — The token's created Datetime. -Usage Instruction 1. Format: ISO 8601 YYYY-MM-DDThh:mm:ssTZD 2. Sample: 2017-07-17T13:42:40+01:00. 3. Evonet may include this field in response 4. Field Type: Datetime - `updateTime` string, date-time — The token's last updated Datetime. -Usage Instruction 1. Format: ISO 8601 YYYY-MM-DDThh:mm:ssTZD 2. Sample: 2017-07-17T13:42:40+01:00. 3. Evonet may include this field in response 4. Field Type: Datetime - `status` 'disabled' | 'enabled' | 'expired', required — The status of token - Usage Instruction 1. Evonet may include this field in response 2. Field Type: String(20) - `e-wallet` object — This is used to send E-Wallet related Information for this token - Usage Instruction 1. For GET PaymentMethod response, Evonet may include this field in response. 2. For GET PaymentMethod response, if the token is E-Wallet token, this object will be returned with token object in the same unit of array. - `paymentBrand` string, required — This is to indicate the payment brand of E-Wallet. - Value defined Alipay: Alipay CN Alipayplus: Alipay+ WeChat_Pay: WeChat Pay - Usage Instruction 1. Evonet may include this field in response 2. Field Type: String(32) - `planID` string — This is the ID assigned by WeChat, when merchant obtained the license for some special service like Recurring Payment from WeChat - Usage Instruction 1. Evonet may include this field in response 2. Field Type: String(1024) - `contractID` string — This is the Code assigned by WeChat, after user completed sign contract with WeChat pay in mini program. - Usage Instruction 1. Evonet may include this field in response 2. Field Type: String(1024) - `subOpenID` string — This is the user ID for a User in merchant's Mini-Program of WeChat - Usage Instruction 1. Evonet may include this field in response 2. Field Type: String(64) - `card` object — This is used to send card related Information for this token - Usage Instruction 1. For GET PaymentMethod response, Evonet may include this field in response. 2. For GET PaymentMethod response, if the token is card token, this object will be returned with token object in the same unit of array. - `first6No` string, required — The first 6 digits of the card number - Usage Instruction 1. This field is used in response from Evonet 2. Field Type: String(6) - `last4No` string, required — The last 4 digits of the card number - Usage Instruction 1. This field is used in response from Evonet 2. Field Type: String(4) - `paymentBrand` 'Diners' | 'UnionPay' | 'Visa' | 'Mastercard' | 'JCB' | 'American_Express' | 'TPN' — This is used to indicate the card scheme which the card belongs to - Value defined The accepted values of this field, please refer to card paymentMethod type of the Appendix 8.8 payment brands - Usage Instruction: 1. This is used in response from Evonet 2. Field Type: String(32) - `fundingType` string — This is used to indicate the type of the card - Value defined credit debit prepaid - Usage Instruction 1. This field is used in response from Evonet 2. Field Type: String(32) - `holderName` string — The cardholder name - Usage Instruction 1. This field is used in the response from Evonet 2. Field Type: String(50) - `issuingBank` string — The name of Issuing Bank - Usage Instruction 1. This field is used in response from Evonet 2. Field Type: String(16) - `issuingCountry` string — The card issuing country. - Usage Instruction 1. This field is used in response from Evonet 2. The three-character country code as defined in ISO-3166-1 alpha-3. For example, SGP. 3. Field Type: String(3) - `issuerCountry` string — The cardholder's country. - Usage Instruction 1. This field is used in response from Evonet 2. The three-character country code as defined in ISO-3166-1 alpha-3. For example, SGP. 3. Field Type: String(3) - `isCommercial` boolean — This is used to response whether the card is a business card. -Value defined true: this card is a business card false: this card is not a business card - Usage Instruction 1. This field is used in response from Evonet 2. Field Type: boolean - `networkToken` object — This object is used to send network token related Information for this transaction - Usage Instruction 1. For POST PaymentMethod response, if the request generated a network token, the field will be present. - `status` 'enabled' | 'suspended' | 'disable', required — The status of Network Token - Usage Instruction 1. Field Type: String(32) - `supportDeviceBinding` boolean, required — Does current network token support device binding? - Value definition true: support false: unsupport -Uasge Instruction If current network token support device binding, you can use PUT PaymentMethod to continue the binding. - `tokenID` string, required — The unique ID of the network token assigned by card scheme - Usage Instruction 1. Evonet may include this field in response. 2. Field Type: String(64) - `first6No` string, required — The first 6 digits of the network token - Usage Instruction 1. This field is used in response from Evonet 2. Field Type: String(6) - `last4No` string, required — The last 4 digits of the network token - Usage Instruction 1. This field is used in response from Evonet 2. Field Type: String(4) - `expiryDate` string, required — The expiration date of the network token -Usage Instruction 1. Format: MMYY - `paymentAccountReference` string — Payment Account Reference (PAR) if available for this payment instrument. - Usage Instruction 1. This field is used in response from Evonet 2. Field Type: String(64) - `tokenReferenceID` string — It is a unique ID associated with a single token. - Usage Instruction 1. This field is used in response from Evonet 2. Field Type: String(64) - `authentication` object — The information used for User authentication with Card - Usage Instruction 1. Evonet supports securePlus and threeDS authentication types - `type` 'threeDSPage' | 'threeDSIntegrator' | 'FIDOPage' | 'threeDSPageOrFIDOPage' | 'threeDSIntegratorOrFIDOPage' — This is used for Evonet to response merchant which authentication type is applied for this transaction. - Usage Instruction: 1. In the request from merchant, only threeDSPage and threeDSIntegrator are applied 2. In the response from Evonet, all the values are applied. 3. If merchant is configured to support 3DS authentication in Evonet, merchant can send this field in the request of POST PaymentMethod and POST Payment, if not present, default value of threeDSPage is applied 4. If merchant is configured to support 3DS or SecurePlus authentication in Evonet, and authentication is performed, in the response of POST PaymentMerthod and POST Payment, Evonet will include this field to indicate the authentication type 5. In PUT Payment and PUT PaymentMethod request, the value this field must same as POST request, if not present, default value is threeDSPage. 6. Field Type: String(20) - `threeDS` object — This field includes the related information for 3DS authentication - Usage Instruction 1. Merchant can use this object to send information to Evonet for 3DS authentication 2. If authenticationOnly=true, Evonet sends the 3DS result data (mpiData) to merchant in this field. 3. Merchant can use this object to send 3DS result data (mpiData) to Evonet for payment. 4. If the authentication is finished, Evonet will return the eci and status in this object. 5. If the transaction has been verified by 3DS, Evonet sends the 3DS result data (mpiData) to merchant in this field. - `mpiData` object, required — The 3DS authentication result data - Usage Instruction 1. Evonet will response this data to merchant in POST Payment or PUT Payment response, if authenticationOnly=true in the request of POST Payment 2. Mandatory when merchant obtains this data from other service provider, and send to Evonet in POST Payment 3. Evonet will response this data to merchant in POST Payment, PUT Payment or GET Payment response, if the transaction has been verified by 3DS. - `status` 'Y' | 'N' | 'U' | 'A' | 'C' | 'R', required — The raw result of the 3DS to indicate the status of the E-Commerce transaction, used for the follow-up authorization request. - Usage Instruction 1. Field Type: String(1). - `transStatusReason` string — 3DS result reason - Usage Instruction 1. The description of each value, please find in appendix 8.10 2. Field Type: String(2). - `cardholderInfo` string — Text provided by the ACS/Issuer to Cardholder during a Frictionless transaction that was not authenticated by the ACS. The Issuer can optionally provide information to Cardholder. - Usage Instruction 1. Field Type: String(1024). - `cavv` string — The cavv. The field is authentication value(AV) for 3DS 2.0. The base64 encoded value is accepted or returned in this field. - Usage Instruction 1. Field Type: String(28). - `eci` string — The electronic commerce indicator. - Usage Instruction 1. Field Type: String(2). - `dsTransID` string — dsTransID - Usage Instruction 1. Mandatory for 3D Secure 2 2. Field Type: String (36) - `threeDSVersion` string — threeDSVersion - Usage Instruction 1. Mandatory for 3D Secure 2. 2. The current version supported is 2.1.0. 3. Field Type: String(10). - `isFrictionless` 'Y' | 'N' — This field is used to indicate the mode of the 3DS is frictionless or challenge - `metadata` string — This field is used for merchant to state reference information - Usage Instruction 1. If merchant sends this field in the request message, Evonet will echo it back in the response 2. Field Type: String(512) --- [API](https://skmtc.net/evonetonline/apis/evonet-api.md) · [All operations](https://skmtc.net/evonetonline/apis/evonet-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/evonetonline/evonet-api/revisions/2136e26ceb19/schema)