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

Recurring - Payment API Credit Card

17min

About Recurring - Payment API Credit Card





 Recurring type is another

feature that can pay a particular bill from your

periodically with

same amount similar to

initial bill

.

The

 used in this

stage is similar to


for Full

& Installment and Pre-Auth & Capture

types. However, there are differences in

sent

request.



 will give a recurringToken as


response

called recurring token making.

can use recurringToken on

later


request without using cardNo and cardExpYymm.



Recurring - Payment API Credit Card (First Payment)



To activate



recurring type

, you mandatory pay

created

to receive

recurringToken beforehand.

API Endpoint

/nicepay/direct/v2/payment

Request Method

application/x-www-form-urlencoded

POST

Description

Recurring

Merchant Token

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

The used

 specification is similar to

API Recurring Token Credit Card.



Request Payment for Credit Card Recurring (First Payment)



The following is a request

 on recurring to gain recurringToken which where You need to finish

Recurring - Registration API Credit Card beforehand.

You still need cardNo, cardExpYymm, cardCvv, cardHolderNm & cardHolderEmail from



on

first

on this recurring scheme.

Parameter

Type

Size

Description

Example / Notes

timeStamp

Required

N

14

Request Timestamp (YYYYMMDDHH24MISS)

20230522080502

tXid

Required

AN

30

Transaction ID

IONPAYTEST01202305220041509298

referenceNo

Required

ANS

40



 Order Number

MerchantReferenceNumber001

merchantToken

Required

AN

255



 Token

ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae

cardNo

Required

N

20



 Number

51234500****0000

cardExpYymm

Required

A

4

Card Expiry (YYMM)

3901

cardCvv

Required

N

4

Card CVV

100

cardHolderNm

Required

AN

45

Card Holder Name

John Doe

cardHolderEmail

Required

ANS

100

Card Holder Email

callBackUrl

Required

ANS

255



 Result URL

https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp



Response Parameter for Credit Card Recurring (First Payment)



Below is

 detailed response You get.

perform save & store

recurringToken gain to execute

recurring feature

on

next

with

same


.

Parameter

Type

Size

Description

Example / Notes

timeStamp

N

14

Response Date

(YYYYMMDDHH24MISS)

20230520135959

resultCd

N

4

Result Code

0000

resultMsg

AN

255

SUCCESS

tXid

AN

30

Transaction ID

IONPAYTEST01202305161007570327

referenceNo

ANS

40



 Order Number

MerchantReferenceNumber001

payMethod

N

2

01



When Success

amount

N

12



 Amount

10000



When Success

currency

AN

3

Currency

IDR



When Success

goodsNm

AN

100

Goods Name



 Goods 1



When Success

billingNm

AN

100

Buyer Name

John Doe



When Success

transDt

N

8

Transaction Date

(YYYYMMDD)

20230516



When Success

transTm

N

6

Transaction Time

(HH24MISS)

135959



When Success

description

AN

100

Transaction Description

This Is The Description Of The





When Success

authNo

N

10

Approval Number

123456



When Success

issuBankCd

A

4

CENA (Refer

 Code)



When Success

acquBankCd

A

4

BNIA (Refer

 Code)



When Success

cardNo

AN

20

Card Number (Masked)

51234500****0008



When Success

cardExpYymm

N

4

Card Expiry

(YYMM)

3901



When Success

instmntMon

N

1

Installment Month

1



When Success

instmntType

N

2

1



When Success

ccTransType

AN

2

1 Normal

2 Recurring

3 Pre-Auth

4 Capture

2



When Success

vat

N

12

Value Added Tax (

)

0



When Success

fee

N

12

Service Fee

0



When Success

notaxAmt

N

12

Tax Free Amount

0



When Success

recurringToken

AN

64

Token That Using Recurring Payment

f19e3128784d0b33c189d5df21321c781b5bd107b185587fd8a54781aa845c84

acquBankNm

A

255

Acquiring

 Name

CIMB

issuBankNm

A

255

Issuing

 Name

BCA



Sample for Credit Card Recurring (First Payment)

Sample Request Recurring Payment
Sample Response Recurring Payment
Java Request




Continual Recurring - Payment API Credit Card



After

ing with

first

and already receiving recurringToken on Recurring - Payment API Credit Card.

You can use that recurringToken to pay another bill using a similar



credential to implement recurring (subscription)

mechanism. However, to

this

continual recurring, You still need to beforehand do


registration on Recurring - Registration API Credit Card.

The following is

 request and response detail used on

later

using

same recurring token.

API Endpoint

/nicepay/direct/v2/payment

Request Method

application/x-www-form-urlencoded

POST

Description

Recurring Continual




Merchant Token

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



 specification used is similar to

API Recurring Token Credit Card



Request Payment for Credit Card Recurring



You only need to use recurringToken on



Recurring for this next request without using cardNo and cardExpYymm

.

Parameter

Type

Size

Description

Example / Notes

timeStamp

Required

N

14

Request Timestamp (YYYYMMDDHH24MISS)

20230522080502

tXid

Required

AN

30

Transaction ID

IONPAYTEST01202305220041509298

referenceNo

Required

ANS

40



 Order Number

MerchantReferenceNumber001

merchantToken

Required

AN

255



 Token

ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae

recurringToken

Required

AN

64

Token That Using Recurring Payment

When Success f19e3128784d0b33c189d5df21321c781b5bd107b185587fd8a54781aa845c84

cardCvv

Required

N

4

Card CVV

100

cardHolderNm

Required

AN

45

Card Holder Name

John Doe

cardHolderEmail

Required

ANS

100

Card Holder Email

callBackUrl

Required

ANS

255



 Result URL

https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp

Include cardCVV on every

 depending on

MID type of CVV or Non-CVV.



Response Payment for Credit Card Recurring



Parameter

Type

Size

Description

Example / Notes

timeStamp

N

14

Response Date

(YYYYMMDDHH24MISS)

20230520135959

resultCd

N

4

Result Code

0000

resultMsg

AN

255

SUCCESS

tXid

AN

30

Transaction ID

IONPAYTEST01202305161007570327

referenceNo

ANS

40



 Order Number

MerchantReferenceNumber001

payMethod

N

2

01



When Success

amount

N

12



 Amount

10000



When Success

currency

AN

3

Currency

IDR



When Success

goodsNm

AN

100

Goods Name



 Goods 1



When Success

billingNm

AN

100

Buyer Name

John Doe



When Success

transDt

N

8

Transaction Date

(YYYYMMDD)

20230522



When Success

transTm

N

6

Transaction Time

(HH24MISS)

224343



When Success

description

AN

100

Transaction Description

This Is The Description Of The





When Success

authNo

N

10

Approval Number

123456



When Success

issuBankCd

A

4

CENA (Refer

 Code)



When Success

acquBankCd

A

4

BNIA (Refer

 Code)



When Success

cardNo

AN

20

Card Number (Masked)

51234500****0008



When Success

cardExpYymm

N

4

Card Expiry

(YYMM)

3901



When Success

instmntMon

N

1

Installment Month

1



When Success

instmntType

N

2

1



When Success

ccTransType

AN

2

1 Normal

2 Recurring

3 Pre-Auth

4 Capture

2



When Success

vat

N

12

Value Added Tax (

)

0



When Success

fee

N

12

Service Fee

0



When Success

notaxAmt

N

12

Tax Free Amount

0



When Success

acquBankNm

A

255

Acquiring

 Name

CIMB

issuBankNm

A

255

Issuing

 Name

BCA



Sample JSON for Credit Card Recurring Payment


Sample Request Continual Payment
Sample Response Continual Payment
Sample Java Request Continual




CallBack Handling for Credit Card Payment



tXid will never similar with

 request hold. Capture

will ensure that

capture amount value won't exceed

owned funds.

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