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