NICEPAY API
...
Checkout API
Payment - API Checkout

Credit Card - API Checkout

33min

Tentang Credit Card - API Checkout



Terdapat beberapa hal wajib ketahui dalam menggunakan untuk metode agar lancar bersama kami:

  1. Proses Flow 3Ds/Non-3Ds.
  2. Fitur Full .
  3. Fitur Installment.
  4. Fitur Recurring Token.
  5. Fitur Pre-Auth Token.



Alur Proses



 kunjungi Fitur Kartu Kredit untuk memeriksa penjelasan mengenai 3Ds.

3Ds

Alur Pembayaran CC - Redirect 3Ds
Alur Pembayaran CC - Redirect 3Ds


Deskripsi langkah alur Redirect dengan 3Ds:

  1.  melakukan checkout.
  2.  mengirim data kepada .
  3.  mengajukan menggunakan Registration kepada .
  4.  mendaftarkan data .
  5.  mengalihkan pada milik kepada .
  6.  mengirimkan kepada .
  7.  memilih .
  8.  memasukkan data kartu.
  9.  mengirimkan data kartu kepada .
  10.  mem kalkulasi FDS.
  11.  mengajukan 3Ds kepada .
  12.  melakukan validasi 3Ds.
  13.  mengirimkan response URL 3Ds kepada .
  14.  menerima response verifikasi.
  15.  mengalihkan kepada autentikasi ACS.
  16.  membuat response OTP.
  17.  mengirimkan OTP kepada .
  18.  menerima OTP.
  19.  memasukkan OTP.
  20.  mengirimkan OTP kepada .
  21.  melakukan verifikasi OTP.
  22.  mengirimkan hasil 3Ds kepada .
  23.  menerima hasil pemeriksaan.
  24.  mengajukan kepada .
  25.  melakukan .
  26.  mengirimkan kepada .
  27.  melakukan redirect callbackUrl kepada .
  28.  menampilkan hasil callbackUrl kepada .
  29.  mengirim kepada .
  30.  menerima .
  31.  melakukan pengajuan inquiry ke .
  32.  menerima pengajuan.
  33.  secara otomatis mengirimkan response inquiry kepada .
  34.  menerima terakhir.
  35.  mengirim hasil kepada .



Non-3Ds

Alur Pembayaran CC - Redirect Non-3Ds
Alur Pembayaran CC - Redirect Non-3Ds


Deskripsi langkah alur Redirect dengan Non-3Ds:

  1.  melakukan checkout.
  2.  mengajukan checkout kepada .
  3.  mendaftarkan data checkout.
  4.  mengirimkan response berupa formulir data kartu.
  5.  mengajukan checkout kepada .
  6.  mendaftarkan pesanan dengan menggunakan Registration kepada .
  7.  menyimpan order registration.
  8.  mengalihkan kepada .
  9.  mengirim kepada .
  10.  memilih .
  11.  memasukkan rincian kartu.
  12.  mengajukan menggunakan kepada .
  13.  melakukan kalkulasi FDS.
  14.  mengajukan kepada .
  15.  melakukan verifikasi pengajuan.
  16.  mengirimkan pengajuan konfirmasi kepada .
  17.  mengajukan /charge kepada .
  18.  melakukan .
  19.  mengirim response kepada .
  20.  mengirim menggunakan callBackUrl dan dbProcessUrl kepada .
  21.  menerima .
  22.  mengajukan pemeriksaan kepada .
  23.  mengirimkan response pemeriksaan .
  24.  menerima terakhir.
  25.  mengirimkan hasil pesanan kepada .



NICEPAY Secure Payment Page



 membuka Panduan Bayar Kartu Kredit untuk dapat memberikan panduan kepada dalam metode .

Secure Payment Page
Secure Payment Page


Gambar di atas adalah contoh dengan metode menggunakan Secure Page.

Setelah memilih metode dengan , akan diminta untuk memasukan data kartunya. Sistem akan secara otomatis mengenali jenis kartu BIN seperti gambar di bawah ini, misalnya VISA atau Mastercard, American Express, dan lain-lain nantinya kartunya pun akan berbeda sesuai dengan tipe jenis kartu digunakan.

Setelah selesai memasukkan data kartu, dapat melanjutkan .

Credit Card - Secure Payment Page
Credit Card - Secure Payment Page


Kemudian, akan berjalan. Apabila berhasil maka tampilan akan muncul seperti gambar berikut.

Success -  Secure Payment Page
Success - Secure Payment Page


 kunjungi Payment - API Checkout untuk mengetahui langkah selanjutnya perihal payment handling.



Full Payment Credit Card



Pada Full , membayar secara penuh nominal ditagihkan dalam sekali bayar. Berikut adalah rincian digunakan pada .

Request Parameter Full Payment Credit Card



Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

paymentURL

Required

ANS

14

 URL



https://dev.nicepay.co.id/nicepay/redirect/v2/payment

tXid

Required

AN

30

Transaction ID



IONPAYTEST00202203211640309389

Untuk , dengan Full dan Installment mendapatkan response sama.



Response Parameters Full Payment Credit Card (CallbackUrl) - Payment



Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

status

N

1

0

tXid

AN

30

Transaction ID

IONPAYTEST00202212201540174369



When Success

referenceNo

AN

40

 Order Number

ordNo20221220151243



When Success

payMethod

N

2

01



When Success

amt

N

12

Transaction Amount

1000



When Success

notaxAmt

N

12

Tax Fee Amount

0



When Success

vat

N

12

Value Added Tax ()

0



When Success

fee

N

12

Service Fee

0



When Success

currency

A

3

Currency

IDR



When Success

goodsNm

AN

100

Goods Name

Goods+For+Testing+Credit+Card



When Success

billingNm

A

100

Billing Name

John+Doe



When Success

transDt

N

8

Transaction Date (YYYYMMDD)

20221220



When Success

transTm

N

6

Transaction Time (HH24MISS)

154017



When Success

authNo

N

10

Approval Number

174300



When Success (Additional)

issuBankCd

A

4

BMRI



When Success

acquBankCd

A

4

BMRI



When Success

issuBankNm

A

255

Issuing Name

Mandiri



When Success

acquBankNm

A

255

Acquiring Name

Mandiri



When Success

ccTransType

AN



2

Credit Card Transaction Type:

1: Normal

2: Recurring

3: Pre-Auth

4: Capture

1



When Success

cardNo

ANS

20

Card Number With Masking

46161111****1111



When Success

cardExpYymm

N

4

Card Expiration (YYMM)

2707



When Success

instmntType

N

2

1



When Success

instmntMon

N

2

Installment Month 1: 1 Month/Full , jika instmntType: null/1 3: 3 Months 6: 6 Months 12: 12 Months

1



When Success

recurringToken

AN

255

Recurring Token

null



When Success

preauthToken

AN

255

Pre-Auth Token

null



When Success

matchCl

N

1

1



When Success

merchantToken

AN

255

 Token

8f5b330a549c167b53b4b9fd5f2d2eba897a64235c1610524074ec59f8884e8a



When Success



Sample Parameter for CallbackUrl API Checkout Payment


URL Request
URL Callback
Response Callback


Catatan: Response akan dikirimkan melalui callBackurl dengan Content-type: application/json dan metode: POST Parameter.

Untuk pada , response dari request didapat setelah melakukan Call Request adalah Callback URL.



API Checkout Transaction Payment



API URL

/nicepay/redirect/v2/payment

Request Method

Redirect-GET

Header

Content-Type: application/Form-UrlEncoded

Endpoint di atas dapat digunakan untuk dengan tipe Full , Recurring, dan PAC (Pre-Auth Capture).



Recurring Token



Setelah menyelesaikan Registration - API Checkout dan Payment - API Checkout, maka selanjutnya akan memberikan recurringToken pada response Payment - API Checkout didapatkan.

Pada selanjutnya dengan sama, dapat menggunakan recurringToken tersebut dengan menggunakan pada Recurring - Payment API Credit Card.



Request Parameter Recurring Token



Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

paymentURL

Required

ANS

14

 URL



https://dev.nicepay.co.id/nicepay/redirect/v2/payment

tXid

Required

AN

30

Transaction ID



RECURRTEST00202212221422115631



Response Parameter Recurring Token



Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

status

N

1

0

tXid

AN

30

Transaction ID

RECURRTEST00202212221422115631



When Success

referenceNo

AN

40

 Order Number

ordNo20221222141245



When Success

payMethod

N

2

01



When Success

amt

N

12

Transaction Amount

1000



When Success

notaxAmt

N

12

Tax Fee Amount

0



When Success

vat

N

12

Value Added Tax ()

0



When Success

fee

N

12

Service Fee

0



When Success

currency

A

3

Currency

IDR



When Success

goodsNm

AN

100

Goods Name

Goods+For+Testing+Recurring+Token



When Success

billingNm

A

100

Billing Name

John+Doe



When Success

transDt

N

8

Transaction Date (YYYYMMDD)

20221220



When Success

transTm

N

6

Transaction Time (HH24MISS)

142211



When Success

authNo

N

10

Approval Number

115631



When Success (Additional)

issuBankCd

A

4

OTHR



When Success

acquBankCd

A

4

BMRI



When Success

issuBankNm

A

255

Issuing Name

(empty)



When Success

acquBankNm

A

255

Acquiring Name

Mandiri



When Success

ccTransType

AN



2

Credit Card Transaction Type:

1: Normal

2: Recurring

3: Pre-Auth

4: Capture

1



When Success

cardNo

ANS

20

Card Number With Masking

45321111****1111



When Success

cardExpYymm

N

4

Card Expiry (YYMM)

2712



When Success

instmntType

N

2

1



When Success

instmntMon

N

2

Installment Month 1: 1 Month/Full , jika instmntType: null/1 3: 3 Months 6: 6 Months 12: 12 Months

1



When Success

recurringToken

AN

255

Recurring Token

083333e129dea0535119b71813b1dc67b565e2704958411d2ee2ec2f430d745



When Success

preauthToken

AN

255

Pre-Auth Token

null



When Success

matchCl

N

1

 Amount Match Flag: Notification Match Amount Indicator

1



When Success

merchantToken

AN

255

 Token

f083333e129dea0535119b71813b1dc67b565e2704958411d2ee2ec2f430d745



Sample Parameter Recurring Token Payment


URL Request
URL Callback
Response Callback


Setelah melakukan registrasi (Registration - API Checkout) dan integrasi (Payment - API Checkout) menggunakan ,

  • Jika ingin melakukan Recurring menggunakan Recurring Token sama, silakan melakukan Registrasi kembali pada Registration - API Checkout .
  • Kemudian melakukan dengan menambahkan Recurring Token pada recurringToken dan juga CVV.



Pre-Auth Token



Ketika menandatangani kontrak sebagai PAC (Pre-Auth/Capture), memberikan sebuah preauthToken kepada response Payment - API Checkout. Token tersebut akan digunakan pada capture amount untuk menyelesaikan pada Pre-Auth & Capture - Payment API Credit Card.



Request Parameter Pre-Auth Token



Berikut ini adalah daftar untuk melakukan request Pre-Auth Token . Parameter ini digunakan melalui platform pengujian sebagai salah satu tahapan supaya milik dapat terhubung dengan dari .

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

paymentURL

Required

ANS

14

 URL



https://dev.nicepay.co.id/nicepay/redirect/v2/payment

tXid

Required

AN

30

Transaction ID

PACTEST00100202212221548525731



Response Parameter Pre-Auth Token



Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

status

N

1

5

tXid

AN

30

Transaction ID

PACTEST00100202212221548525731



When Success

referenceNo

AN

40

 Order Number

ordNo20221222151220



When Success

payMethod

N

2

01



When Success

amt

N

12

Transaction Amount

1000



When Success

notaxAmt

N

12

Tax Fee Amount

0



When Success

vat

N

12

Value Added Tax ()

0



When Success

fee

N

12

Service Fee

0



When Success

currency

A

3

Currency

IDR



When Success

goodsNm

AN

100

Goods Name

Goods+For+Testing+Pre+-+Auth+Token



When Success

billingNm

A

100

Billing Name

John+Doe



When Success

transDt

N

8

Transaction Date (YYYYMMDD)

20221222



When Success

transTm

N

6

Transaction Time (HH24MISS)

154852



When Success

authNo

N

10

Approval Number

525731



When Success (Additional)

issuBankCd

A

4

CENA



When Success

acquBankCd

A

44

BMRI



When Success

issuBankNm

A

255

Issuing Name

BCA



When Success

acquBankNm

A

255

Acquiring Name

Mandiri



When Success

ccTransType

AN



2

Credit Card Transaction Type:

1: Normal

2: Recurring

3: Pre-Auth

4: Capture

1



When Success

cardNo

ANS

20

Card Number With Masking

53079511****1111



When Success

cardExpYymm

N

4

Card Expiry (YYMM)

2712



When Success

instmntType

N

2

1



When Success

instmntMon

N

2

Installment Month 1: 1 Month/Full , jika instmntType: null/1 3: 3 Months 6: 6 Months 12: 12 Months

1



When Success

recurringToken

AN

255

Recurring Token

null



When Success

preauthToken

AN

255

Pre-Auth Token

edc46eb30a81ac9753e34003d2d1e910d5aaf0dea620889dffcfcc18621864eb



When Success

matchCl

N

1

 Amount Match Flag:

1



When Success

merchantToken

AN

255

 Token

1bee4b7c84cfb4e04d9d26cd47285bf49a77f252f39a48370094f5e3250b9524

Sample Parameter for Pre-Auth Token Payment


URL Request
URL Callback
Response Callback


Setelah melakukan registrasi dan menggunakan ,

  • Jika ingin melakukan multiple capture dengan menggunakan Pre-Auth Token sama, silakan melakukan registrasi kembali.
  • Kemudian melakukan Capture pada Payment V2 Credit Card dengan menambahkan Pre-Auth Token pada preauthToken beserta memasukkan CVV.



CallBack Handling API Checkout Payment



tXid tidak akan sama dengan request hold. Proses Capture akan memastikan bahwa nilai amount di-capture tidak melebihi dana dimiliki.

Saat Callback diterima callbackUrl Anda, kami merekomendasikan untuk melakukan verifikasi Status dengan menggunakan Status Inquiry - API Checkout.

CallBack Handling sangat penting untuk membantu meminimalisir tindakan Fraud. Kami sangat merekomendasikan untuk melakukan verifikasi menggunakan CallBack parameter.

Alur CallBack Handling
Alur CallBack Handling

URL CallBack
Response CallBack