Payloan - API Checkout

15min

 Tentang Payloan - API Checkout 
﻿
﻿﻿ ini digunakan oleh ﻿ untuk melakukan pengajuan ﻿ kepada ﻿ untuk ﻿ ﻿ menggunakan ﻿ ﻿.
﻿
Alur Proses
﻿
Alur Pembayaran Paylate
﻿
Deskripsi langkah ﻿ dengan ﻿:
﻿﻿ request checkout kepada ﻿.
﻿﻿ mengirimkan ﻿ Registration kepada ﻿.
Pada bagian Registration;
Jika menggunakan Akulaku:
﻿﻿ akan request pesanan kepada Akulaku selaku ﻿ ﻿.
Akulaku akan generate pesanan.
Akulaku mengirimkan response data kepada ﻿.
﻿﻿ akan mengirimkan capture response ﻿ Regist kepada ﻿.
Jika menggunakan Kredivo/Indodana:
﻿﻿ akan menyimpan ﻿ regist.
﻿﻿ akan mengirimkan response ﻿ regist.
﻿﻿ mengirimkan ﻿ ﻿ kepada ﻿.
Kemudian pada bagian Payment;
Jika menggunakan Akulaku:
﻿﻿ mengarahkan ﻿ kepada ﻿ Akulaku.
﻿﻿ melakukan login akun.
﻿﻿ melakukan konfirmasi ﻿ kepada Akulaku selaku ﻿ ﻿.
Akulaku melakukan validasi ﻿.
Akulaku mengalihkan ﻿ dengan callbackUrl.
Jika menggunakan Kredivo/Indodana:
﻿﻿ request checkout kepada ﻿ ﻿.
﻿﻿ ﻿ melakukan ﻿ ﻿.
﻿﻿ ﻿ mengirim response dan mengalihkan ke ﻿ milik ﻿ ﻿.
﻿﻿ melakukan konfirmasi ﻿ kepada ﻿ ﻿.
﻿﻿ ﻿ mengirimkan OTP kepada ﻿.
﻿﻿ memasukkan OTP kepada ﻿ ﻿.
﻿﻿ ﻿ melakukan validasi OTP.
﻿﻿ ﻿ melakukan konfirmasi hasil pesanan kepada ﻿.
Pada bagian Notification;
Jika menggunakan Akulaku:
Akulaku selaku ﻿ ﻿ mengirimkan push capture notif kepada ﻿.
﻿﻿ menyimpan ﻿.
﻿﻿ mengirimkan capture update notification kepada ﻿.
﻿﻿ menampilkan response kepada ﻿.
Jika menggunakan Kredivo/Indodana:
﻿﻿ ﻿ mengirimkan push notification kepada ﻿.
﻿﻿ melakukan validasi terhadap ﻿ ﻿ diterima.
﻿﻿ mengajukan konfirmasi pesanan.
﻿﻿ ﻿ melakukan konfirmasi ﻿ pesanan.
﻿﻿ ﻿ mengirim data konfirmasi pesanan kepada ﻿.
﻿﻿ mengirimkan hasil konfirmasi pesanan.
Jika ﻿ ﻿ ﻿ digunakan adalah Akulaku, ﻿ dapat melakukan konfirmasi bukti ﻿:
﻿﻿ mengirimkan konfirmasi bukti ﻿ kepada ﻿.
﻿﻿ mengajukan konfirmasi bukti ﻿ kepada ﻿.
﻿﻿ mengajukan ﻿ konfirmasi bukti ﻿ kepada Akulaku.
Akulaku melakukan ﻿ konfirmasi bukti ﻿.
Akulaku mengirim response data kepada ﻿.
﻿﻿ mengirim response data kepada ﻿.
﻿﻿ menampilkan hasil data kepada ﻿.
﻿﻿ mengajukan pemeriksaan ﻿ menggunakan ﻿ Status kepada ﻿.
﻿﻿ mengirimkan response pemeriksaan ﻿.
﻿﻿ menerima ﻿ terakhir.
﻿﻿ mengirimkan ﻿ konfirmasi kepada ﻿.
﻿
﻿NICEPAY Secure Payment Page
﻿
Secure Payment Page
﻿
Gambar di atas adalah contoh ﻿ ﻿ dengan metode ﻿ menggunakan ﻿ Secure ﻿ Page.
Success - Secure Payment Page
﻿
Setelah ﻿ request registrasi ﻿ selesai, ﻿ dapat melanjutkan ﻿ ﻿ sampai dengan penyelesaian dengan mengikuti panduan pada ﻿ Panduan Bayar Payloan﻿.
﻿
API Checkout Transaction Payment
﻿
API URL
/nicepay/redirect/v2/payment
Request Method 
Redirect-GET
Header
Content-Type: application/Form-UrlEncoded
﻿
Request Parameters for Payment
﻿
Berikut adalah daftar Request Parameter untuk ﻿ ﻿ ﻿ pada ﻿ ﻿.
Catatan untuk ﻿, silakan berikan pesan peringatan kepada ﻿ untuk membuka melalui perangkat ponsel demi memberikan pengalaman lebih baik kepada ﻿.
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	
﻿
PAYLOANTES00202212201645434449
﻿
Response Parameters (CallbackUrl) - Payment
﻿
Catatan: Response ﻿ 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, Payloan﻿
N
2
﻿Payment Method Code﻿ 
06
﻿
When Success
amt
N
12
Transaction Amount
10000
﻿
When Success
currency
﻿E-Wallet, ﻿Payloan﻿
A
3
Currency
IDR
﻿
When Success
goodsNm
﻿E-Wallet, ﻿Payloan﻿
AN
100
Goods Name	
John+Doe
﻿
When Success
billingNm
﻿E-Wallet, ﻿Payloan﻿
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 ﻿ Name
When Success
acquBankNm
﻿Only CC﻿
A
255
Acquiring ﻿ 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, ﻿Payloan﻿
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 ﻿, jika instmntType: null/1
3: 3 Months
6: 6 Months
12: 12 Months
When Success
timeStamp
N
14
﻿﻿ Request Timestamp
When Success
merchantToken
AN
255
﻿﻿ Token
When Success
﻿

Sample Parameter for CallbackUrl API Checkout Payment
﻿
Pada ﻿ saat Checkout, response dari request ﻿ di-hit adalah Callback URL
Url Request
Response Callback
Url Callback
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=

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=
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=

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 Handling API Checkout Payment
﻿
Saat Callback diterima callbackUrl ﻿, 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
﻿
URL CallBack
Response CallBack
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=
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=
﻿

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

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	PAYLOANTES00202212201645434449

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, Payloan	N	2	Payment Method Code	06 When Success
amt	N	12	Transaction Amount	10000 When Success
currency E-Wallet, Payloan	A	3	Currency	IDR When Success
goodsNm E-Wallet, Payloan	AN	100	Goods Name	John+Doe When Success
billingNm E-Wallet, Payloan	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 Name	When Success
acquBankNm Only CC	A	255	Acquiring 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, Payloan	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 , jika instmntType: null/1 3: 3 Months 6: 6 Months 12: 12 Months	When Success
timeStamp	N	14	Request Timestamp	When Success
merchantToken	AN	255	Token	When Success

E-Wallet - API Checkout

QRIS - API Checkout

Payloan - API Checkout

Tentang Payloan - API Checkout

Alur Proses

﻿NICEPAY Secure Payment Page

API Checkout Transaction Payment

Request Parameters for Payment

Response Parameters (CallbackUrl) - Payment

Sample Parameter for CallbackUrl API Checkout Payment

CallBack Handling API Checkout Payment

Selamat Datang di NICEPAY DOCS

NICEPAY Secure Payment Page