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

Recurring - Payment API Credit Card

17min

Tentang Recurring - Payment API Credit Card



Pembayaran tipe Recurring adalah fitur lain dari dapat melakukan suatu tagihan dari secara berkala dengan nominal sama seperti ditagihkan pada awal .

 digunakan pada tahap ini sama dengan untuk tipe Full & Installment dan Pre-Auth & Capture. Namun, terdapat perbedaan pada request dikirimkan.

 akan memberikan sebuah recurringToken sebagai response disebut sebagai recurring token making. dapat menggunakan recurringToken pada request selanjutnya tanpa menggunakan cardNo dan cardExpYymm.



Recurring - Payment API Credit Card (First Payment)



Untuk dapat mengaktifkan dengan jenis Recurring, wajib membayarkan sudah dibuat untuk mendapatkan recurringToken terlebih dahulu.

API Endpoint

/nicepay/direct/v2/payment

Method

application/x-www-form-urlencoded

POST

Description

Recurring

Merchant Token

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

Spesifikasi digunakan sama dengan API Recurring Token Credit Card.



Request Payment for Credit Card Recurring (First Payment)



Berikut adalah request payment pada Recurring untuk mendapatkan recurringToken di mana diperlukan untuk menyelesaikan Recurring - Registration API Credit Card terlebih dahulu.

 masih membutuhkan cardNo, cardExpYymm, cardCvv, cardHolderNm& cardHolderEmail dari pada pertama dalam skema Recurring ini.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

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)



Berikut adalah rincian response dapatkan. Mohon untuk melakukan save & store recurringToken sudah didapat demi menjalankan fitur Recurring pada selanjutnya dengan sama.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

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

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



Setelah melakukan pertama dan telah mendapatkan recurringToken pada Recurring - Payment API Credit Card (First Payment).

 dapat menggunakan recurringToken tersebut untuk melakukan tagihan lain menggunakan kredensial sama demi menerapkan mekanisme secara berkala atau Recurring (subscription). Namun, untuk menjalankan payment continual recurring ini, tetap diperlukan untuk melakukan registrasi terlebih dahulu pada Recurring - Registration API Credit Card.

Berikut adalah rincian request dan response digunakan pada berikutnya menggunakan recurring token sama.

API Endpoint

/nicepay/direct/v2/payment

Method

application/x-www-form-urlencoded

POST

Description

Recurring Continual

Merchant Token

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

Spesifikasi digunakan sama dengan API Recurring Token Credit Card.



Request Payment for Credit Card Recurring



 hanya perlu menggunakan recurringToken pada Recurring untuk request selanjutnya ini tanpa menggunakan cardNo dan cardExpYymm.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

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

Mencantumkan cardCVV pada setiap bergantung dari MID tipe CVV atau Non-CVV.



Response Payment for Credit Card Recurring



Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

timeStamp

N

14

Response Date

(YYYYMMDDHH24MISS)

20230520135959

resultCd

N

4

Result Code

0000

resultMsg

AN

255

SUCCESS

tXid

AN

30

Transaction ID

IONPAYTEST202206230959067259

referenceNo

ANS

40

 Order Number

MerchantReferenceNumber001

payMethod

N

2

01



When Success

amt

N

12

Payment Amount

10000



When Success

currency

AN

3

Currency

IDR



When Success

goodsNm

AN

100

Goods Name

Merchant 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

CENA (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 tidak akan sama dengan request hold. Proses Capture akan memastikan bahwa nilai amount di-capture tidak melebihi dana dimiliki

Saat Callback telah diterima callbackUrl , kami sangat menganjurkan untuk melakukan verifikasi menggunakan Status Inquiry - API Credit Card.

CallBack Handling dapat sangat membantu untuk meminimalisir terjadinya Fraud, kami sangat merekomendasikan {{merc}} untuk melakukan verifikasi CallBack Handling.

URL CallBack
Response CallBack