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

Updated 15 Jan 2025

Did this page help you?

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