Paylater - API Checkout

16 min

Tentang Paylater - API Checkout

API ini digunakan oleh Merchant untuk melakukan pengajuan pembayaran kepada NICEPAY untuk metode pembayaran Paylater menggunakan Checkout API.

Alur Proses

Alur Pembayaran Paylater

Deskripsi langkah pembayaran dengan Paylater:

Pelanggan request checkout kepada Merchant.

Merchant mengirimkan API Registration kepada NICEPAY.

Pada bagian Registration;

Jika menggunakan Akulaku:

NICEPAY akan request pesanan kepada Akulaku selaku Paylater Partner.

Akulaku akan generate pesanan.

Akulaku mengirimkan response data kepada NICEPAY.

NICEPAY akan mengirimkan capture response API Regist kepada Merchant.

Jika menggunakan Kredivo/Indodana:

NICEPAY akan menyimpan order regist.

NICEPAY akan mengirimkan response order regist.

Merchant mengirimkan API Payment kepada NICEPAY.

Kemudian pada bagian Payment;

Jika menggunakan Akulaku:

NICEPAY mengarahkan Pelanggan kepada halaman Akulaku.

Pelanggan melakukan login akun.

Pelanggan melakukan konfirmasi pembayaran kepada Akulaku selaku Paylater Partner.

Akulaku melakukan validasi pembayaran.

Akulaku mengalihkan Pelanggan dengan callbackUrl.

Jika menggunakan Kredivo/Indodana:

NICEPAY request checkout kepada Paylater Partner.

Paylater Partner melakukan proses checkout.

Paylater Partner mengirim response dan mengalihkan ke halaman milik Paylater Partner.

Pelanggan melakukan konfirmasi pembayaran kepada Paylater Partner.

Paylater Partner mengirimkan OTP kepada Pelanggan.

Pelanggan memasukkan OTP kepada Paylater Partner.

Paylater Partner melakukan validasi OTP.

Paylater Partner melakukan konfirmasi hasil pesanan kepada Pelanggan.

Pada bagian Notification;

Jika menggunakan Akulaku:

Akulaku selaku Paylater Partner mengirimkan push capture notif kepada NICEPAY.

NICEPAY menyimpan notifikasi.

NICEPAY mengirimkan capture update notification kepada Merchant.

Merchant menampilkan response kepada Pelanggan.

Jika menggunakan Kredivo/Indodana:

Paylater Partner mengirimkan push notification kepada NICEPAY.

NICEPAY melakukan validasi terhadap notifikasi yang diterima.

NICEPAY mengajukan konfirmasi pesanan.

Paylater Partner melakukan konfirmasi proses pesanan.

Paylater Partner mengirim data konfirmasi pesanan kepada NICEPAY.

NICEPAY mengirimkan hasil konfirmasi pesanan.

Jika Paylater Partner yang digunakan adalah Akulaku, Pelanggan dapat melakukan konfirmasi bukti pembayaran:

Pelanggan mengirimkan konfirmasi bukti pembayaran kepada Merchant.

Merchant mengajukan konfirmasi bukti pembayaran kepada NICEPAY.

NICEPAY mengajukan proses konfirmasi bukti pembayaran kepada Akulaku.

Akulaku melakukan proses konfirmasi bukti pembayaran.

Akulaku mengirim response data kepada NICEPAY.

NICEPAY mengirim response data kepada Merchant.

Merchant menampilkan hasil data kepada Pelanggan.

Merchant mengajukan pemeriksaan status menggunakan API Status kepada NICEPAY.

NICEPAY mengirimkan response pemeriksaan status.

Merchant menerima status terakhir.

Merchant mengirimkan status konfirmasi kepada Pelanggan.

NICEPAY Secure Payment Page

Secure Payment Page

Gambar di bawah adalah contoh Checkout pembayaran dengan metode Paylater menggunakan NICEPAY Secure Payment Page.

Paylater - Secure Payment Page

Setelah proses request registrasi pembayaran selesai, Anda dapat melanjutkan proses transaksi sampai dengan penyelesaian dengan mengikuti panduan pada halaman Panduan Bayar Paylater.

Success - Secure Payment Page

API Checkout Transaction Payment

API URL	/nicepay/redirect/v2/payment
Request Method	Redirect-GET
Header	Content-Type: application/Form-UrlEncoded

Request Parameter for Paylater - API Checkout (CallbackUrl)

Berikut adalah daftar Request Parameter untuk API Payment Paylater pada Checkout API.

Catatan untuk Paylater, silakan berikan pesan peringatan kepada Pelanggan untuk membuka melalui perangkat ponsel demi memberikan pengalaman lebih baik kepada Pelanggan.

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
paymentURL Required	ANS	14	Payment URL	https://dev.nicepay.co.id/nicepay/redirect/v2/payment
tXid Required	AN	30	Transaction ID	PAYLOANTES00202212201645434449

Response Parameter for Paylater - API Checkout (CallbackUrl)

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

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
resultCd	N	4	Result Code	0000
resultMsg	AN	255	Result Message: Error Code	SUCCESS
tXid	AN	30	Transaction ID	PAYLOANTES00202212201645434449 When Success
referenceNo	ANS	40	Order Number	ORD20221220161200 When Success
payMethod E-Wallet, Paylater	N	2	Payment Method Code	06 When Success
amt	N	12	Transaction Amount	10000 When Success
currency E-Wallet, Paylater	A	3	Currency	IDR When Success
goodsNm E-Wallet, Paylater	AN	100	Goods Name	John+Doe When Success
billingNm E-Wallet, Paylater	A	100	Billing Name	John+Doe When Success
transDt	N	8	Transaction Date (YYYYMMDD)	20221220 When Success
transTm	N	6	Transaction Time (HH24MISS)	164543 When Success
description	AN	100	Transaction Description	Test+Transaction+Nicepay When Success
authNo Only CC	N	10	Approval Number	When Success
issuBankCd Only CC	A	4	Issuing Bank Code	When Success
acquBankCd Only CC	A	4	Acquiring Bank Code	When Success
issuBankNm Only CC	A	255	Issuing Bank Name	When Success
acquBankNm Only CC	A	255	Acquiring Bank Name	When Success
cardNo Only CC	ANS	20	Card Number with Masking	When Success
recurringToken Only CC (Additional)	AN	255	Recurring Token	When Success
preauthToken	AN	255	Pre-Auth Token	null When Success
ccTransType	AN	2	Credit Card Transaction Type: 1: Normal 2: Recurring 3: Pre-Auth 4: Capture	When Success
mitraCd Direct Debit, E-Wallet, Paylater	A	4	Mitra Code	KDVI When Success
receiptCode	ANS	20	Authorization Number	When Success
mRefNo	AN	18	Reference Number	When Success
cardExpYymm	N	4	Card Expiry (YYMM)	When Success
instmntType	N	2	Installment Type Code	When Success
instmntMon	N	2	Installment Month 1: 1 Month/Full Payment, jika instmntType: null/1 3: 3 Months 6: 6 Months 12: 12 Months	When Success
timeStamp	N	14	API Request Timestamp	When Success
merchantToken	AN	255	Merchant Token	When Success

Sample Parameter for Paylater - API Checkout (CallbackUrl)

Pada pembayaran saat Checkout, response dari request yang di-hit adalah Callback URL.

Request Parameter

curl -X GET "https://www.merchant.com/callbackUrl?resultCd=0000&resultMsg=SUCCESS&tXid=PAYLOANTES00202212201645434449&referenceNo=ORD20221220161200&payMethod=06&amt=10000&transDt=20221220&transTm=164543&description=Test+Transaction+Nicepay&authNo=&issuBankCd=&acquBankCd=&cardNo=&receiptCode=&mitraCd=KDVI&recurringToken=&preauthToken=&currency=IDR&goodsNm=John+Doe&billingNm=John+Doe&ccTransType=&mRefNo=&instmntType=&instmntMon=&cardExpYymm=&issuBankNm=&acquBankNm=&timeStamp=&merchantToken="

Callback Parameter

resultCd=0000
resultMsg=SUCCESS
tXid=PAYLOANTES00202212201645434449
referenceNo=ORD20221220161200
payMethod=06
amt=10000
transDt=20221220
transTm=164543
description=Test+Transaction+Nicepay
authNo=
issuBankCd=
acquBankCd=
cardNo=
receiptCode=
mitraCd=KDVI
recurringToken=
preauthToken=
currency=IDR
goodsNm=John+Doe
billingNm=John+Doe
ccTransType=
mRefNo=
instmntType=
instmntMon=
cardExpYymm=
issuBankNm=
acquBankNm=
timeStamp=
merchantToken=

Callback Handling API Checkout Payment

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

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

Alur Callback Handling

resultCd=0000
resultMsg=SUCCESS
tXid=PAYLOANTES00202212201645434449
referenceNo=ORD20221220161200
payMethod=06
amt=10000
transDt=20221220
transTm=164543
description=Test+Transaction+Nicepay
authNo=
issuBankCd=
acquBankCd=
cardNo=
receiptCode=
mitraCd=KDVI
recurringToken=
preauthToken=
currency=IDR
goodsNm=John+Doe
billingNm=John+Doe
ccTransType=
mRefNo=
instmntType=
instmntMon=
cardExpYymm=
issuBankNm=
acquBankNm=
timeStamp=
merchantToken=