NICEPAY API
...
API Credit Card
Payment - API Credit Card

Full Payment & Installment - Payment API Credit Card

11min

About Full Payment & Installment - Payment API Credit Card



This

 uses after finishing


Full Payment & Installment - Registration API Credit Card.

used in this stage is similar to


for

Recurring Token and Pre-Auth & Capture

type. However, there are several differences in

sent request

.



Full Payment & Installment - Payment API Credit Card



API Endpoint

/nicepay/direct/v2/payment

Request Method

POST

Description

Full

 & Installment -




Merchant Token

SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)

Request Format

application/x-www-form-urlencoded

On




, if 3Ds authentication is needed, your

will direct to

3Ds card Issuer


to input

OTP (One Time Password) code to finish



.



Request Parameter for Credit Card Payment



The following is

 list of request

s to




on


Full

& Installment

. Request Parameter

s through Form-Url with

following detailed

.

Parameter

Type

Size

Description

Example / Notes

timeStamp

Required

N

14

Request Timestamp (YYYYMMDDHH24MISS)

20221202141217

tXid

Required

AN

30

Transaction ID

IONPAYTEST01202212021455054652

referenceNo

N

40

Reference Number for



ordNo20221202141217

cardNo Required for CC 

N

20



 Number

4434260000000008

cardExpYymm Required for CC  

A

4

Card Expiry (YYMM)

3901

cardCvv Required for CC

N

4

Card CVV

101

cardHolderNm Required 

AN

45

Card Holder Name

John Doe

cardHolderEmail Required

ANS

100

Card Holder Email

merchantToken Required 

AN

255



 Token

c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae

callBackUrl Required 

ANS

255



 Result URL

https://merchant.com/callBackUrl

Parameter needed in




is

Your

Credit/Debit card data such as cardNo, cardExpYymm, cardCvv, cardHolderNm & cardHolderEmail.

So, to do




, we suggest You get

card data from Your

beforehand before doing




.

Include cardCVV on every

 depending on

MID type of CVV or Non-CVV.



Response Parameter for Credit Card Payment



After you request, you will get a response from URL Callback with

 following detailed response

.

Parameter

Type

Size

Description

Example / Notes

resultCd

N

14

Result Code



resultMsg

AN

255

Result message: Error Code



tXid

AN

30

Transaction ID

When success

referenceNo

ANS

40



 Order Number

When success

payMethod

N

2

When success

amt

N

12



 Amount

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

Masked Card No

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

ccTransType

N

2

1: Normal 2: Recurring 3: Pre-Auth 4: Capture

When Success, CC



Sample Request JSON for Credit Card Payment


Form-UrlEncoded
Java Request




CallBack Handling for Credit Card Payment



After



occurs, You will get a

from us based on

inputted Callback URL in

request

on Payment - API Credit Card.

When Your callback already received callbackUrl, we recommended



to do


verification using

Status Inquiry - API Credit Card.

CallBack Handling is very important to minimize

 Fraud act, we highly recommend


to do

verification using callBack Handling.

URL CallBack
Response CallBack