Encryption - Payment API Credit Card
Encryption - Payment API Credit Card is the Credit Card payment transaction data that must going through encryption process firsthand from the Merchant side.
API Endpoint | /nicepay/direct/v2/payment |
|---|---|
Request Method | Popup, Redirect, Submit, Etc(Not Server to Server API) Only support POST |
Description |
|
Merchant Token | SHA256(timeStamp+iMid+referenceNo+amt+merchantKey) |
Request Format | SHA256 (publicKey) |
API Payment - Credit Card which used on this encryption are similar with Credit Card features Full Payment & Installment, Recurring and Preauth & Capture.
The difference is on the Card Data parameter (cardNo,cardExpYymm,cardCvv and cardHolderNm) which Merchant must give those parameter through encryption process firsthand during proceeding the payment request to NICEPAY.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
|---|---|---|---|---|
timeStamp Required | N | 14 | API Request Timestamp (YYYYMMDDHH24MISS) | 20221202141217 |
tXid Required | AN | 30 | Transaction ID | IONPAYTEST01202212021455054652 |
cardNo Required | N | 200 | Full card number using encrypted format & base64 url encode | n9AuywVp0Cgk7M9sJaJbWf43%2F6m FI6xzLnqZljsimVdNAEq56p6m6Ckhyrd cL14e5tCZlrwQzso6pVCpn%2FwgpPm WwK%2BR0ByoPuYh%2FFwnJy%2BO BWWLroefE7lPoXaWoSUzXw%2BQPw MaT7VQxZnDeIs19dQ%2FE28pcgfTeD 0xDqaBdtQ%3D |
cardExpYymm Required | A | 200 | Card Expiry (YYMM) using encrypted format & base64 url encode | q6Ye2qcjxrjUq%2B3KyCTErSf1nPu58%2FMaS4rP7qThLLEfx9FdFDYp3snj%2F QKRzATATQBdsM3tcY5itH29yGPGn9y MB1k19zTUGtiU9n9NflqUIW%2BCTtv 4Z0ykWFxZntBJ3YMGChmanGIADI9% 2FDUrl5pLNPvAL9Ags5xn3FfOY8RU%3 D |
cardCvv Required | N | 200 | Card CVV using encrypted format & base64 url encode | fPXQ8fdw1Y0tbFmDtaolUxQteh7I3RZ qYY6%2B0g%2BWOPyKTHm5cRTq%2 BD7CYEsvlIRsVcJbzm4LgTNbFWP5rva HkoPqIQmAZRf0CQl1UUQUYwFa%2B NGWObg3depYbXWDpifMtwoVE7Jd3 zFp4B0Ik23Ha46B0bDvRi1zQiz%2Bx7 NwZkE%3D |
cardHolderNm Required | AN | 200 | Card Holder Name using encrypted format & base64 url encode | jY6lRWSw%2Bo9815Dx8jacPVvIjX1wi0 QiovNbIEoGwEwmKzzD92n8vVDI3Rw XFlu2hQTFk0w6iBGlNAPROvl5uPR3% 2Fo4Gy0p3U8RJKIeUnH1qGjP7fO69N dvV6gTwo1Ehjs0cMsIbVNyUBlBQ72b TTkVkQzpAUGQhVQuwbwaw6hs%3D |
recurringToken Required for Recurring Payment Only | AN | 64 | Recurring Token | 9338d54573688ae18e175240b0257d e48d89c6ef1c9c7b5c094dc4beed9e4 35f |
preauthToken Required for Capture Process in Preauth Only | AN | 64 | Pre-Auth Token | 9338d54573688ae18e175240b0257d e48d89c6ef1c9c7b5c094dc4beed9e4 35f |
iMid Required | AN | 10 | Merchant Id | IONPAYTEST |
merchantToken Required | AN | 255 | c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae | |
callBackUrl Required | ANS | 255 | https://merchant.com/callBackUrl | |
encrypted Required | N | 1 | Flagging for payment transaction use encryption or not | 1 = Using Encrypt Method 0 = Not Using |
publicKey Required | AN | 64 | publicKey Hashing of your public key (SHA256) | a5f3445e7dd166b8c6cfef685047098f1a03755aeedb97a06002d7a754081338 |
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
|---|---|---|---|---|
resultCd | N | 14 | code of responses | |
resultMsg | AN | 255 | Result message: Error Code | Responses message |
tXid | AN | 30 | Transaction ID | When success |
referenceNo | ANS | 40 | When success | |
payMethod | N | 2 | When success | |
amt | N | 12 | When success | |
currency | AN | 3 | Currency | When success |
goodsNm | A | 100 | Goods Name | When success |
billingNm | A | 100 | Buyer Name | When success |
transDt | N | 8 | Transaction Date (YYYYMMDD) | When success |
transTm | N | 6 | Transaction Time (HH24MISS) | When success |
description | AN | 100 | Transaction Description | When success |
authNo | N | 10 | Approval Number | When success, CC |
issuBankCd | A | 4 | When success, CC | |
acquBankCd | A | 4 | When success, CC | |
cardNo | ANS | 20 | Card Number with Masking | When success, CC |
cardExpYymm | N | 4 | Card Expiry (YYMM) | When success, CC |
instmntMon | N | 2 | Installment Month | When success, CC |
instmntType | N | 2 | When success, CC | |
recurringToken | AN | 64 | Recurring Payment Token | When Success CC Recurring |
preauthToken | AN | 64 | Pre-Auth Payment Token | When Success CC Pre-Auth |
ccTransType | N | 2 | When Success, CC 1: Normal 2: Recurring 3: Pre-Auth 4: Capture | |
Vat | N | 12 | Vat | When Success, CC |
Fee | N | 12 | Service Fee | When Success, CC |
noTaxAmt | N | 12 | Tax-free Amount | When Success, CC |
mitraCd | A | 4 | Mitra Code | When success ClickPay, E-Wallet, Payloan |
receiptCode | ANS | 20 | Authorization No | When success ClickPay |
mRefNo | AN | 18 | Bank Reference No | When success ClickPay |
cardBrand | N | 2 | Card brand name | 1 = Visa 2 = Mastercard 3 = JCB 4 = Amex 5 = Others |
