Payment - API Checkout

10min

Menampilkan Payment Page dari PaymentURL
﻿
Ketika 
﻿ berhasil mendaftarkan request 
﻿ pada Registration - API Checkout﻿, 
﻿ akan mendapatkan response berupa paymentURL. Untuk menampilkan payment page di sisi Front-end, 
﻿ diperlukan untuk melakukan mapping paymentURL tersebut terlebih dahulu dengan tambahan 
﻿ pada URL-nya, yaitu ?tXid= dan dilengkapi dengan txid 
﻿ didapat pada response Registration - API Checkout﻿.
Perhatikan contoh berikut ini.
Text
paymentURL: https://www.nicepay.co.id/nicepay/redirect/v2/payment
txid : IONPAYTEST00202203211640309389

NICEPAY Payment Page: https://www.nicepay.co.id/nicepay/redirect/v2/payment?tXid=IONPAYTEST00202203211640309389
paymentURL: https://www.nicepay.co.id/nicepay/redirect/v2/payment
txid : IONPAYTEST00202203211640309389

NICEPAY Payment Page: https://www.nicepay.co.id/nicepay/redirect/v2/payment?tXid=IONPAYTEST00202203211640309389
﻿
Ketika Payment Page tersebut sudah sesuai, maka 
﻿ 
﻿ 
﻿ ajukan sudah bisa dibayarkan oleh 
﻿. 
﻿ hanya perlu menampilkan tautan atau embedded link tersebut pada website 
﻿ 
﻿ miliki.
Untuk 
﻿ 
﻿ ShopeePay dan OVO, kami sarankan agar 
﻿ 
﻿ membuka 
﻿ 
﻿ melalui perangkat ponsel 
﻿ dimiliki. 
Halaman Pembayaran Berhasil
﻿
Parameter Format Payment Page
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
paymentURL  
﻿Required﻿
ANS
14
﻿
﻿ URL
https://nicepay.co.id/nicepay/redirect/v2/payment
tXid 
﻿Required﻿
AN
30
Transaction ID	
﻿
IONPAYTEST00202203211640309389
﻿
After Payment Handling
﻿
Setelah 
﻿ sudah berhasil dilakukan oleh 
﻿ 
﻿, 
﻿ mengenai 
﻿ 
﻿ tersebut, berhasil maupun gagal, akan terkirim secara otomatis ke 
﻿ 
﻿ melalui 
﻿ callbackURL dan dbProcessURL 
﻿ 
﻿ masukkan pada saat request melalui Registration - API Checkout﻿. 
﻿
﻿ kunjungi 
﻿ Notification - API Checkout﻿ untuk mendapatkan 
﻿ lebih detail mengenai dbProcessURL.
Response Parameters (CallbackUrl) 

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	
IONPAYTEST01202212141112221428
﻿
When success
referenceNo
ANS
40
Order Number
(empty)
﻿
When success
payMethod
﻿E-Wallet, Payloan﻿
N
2
﻿Payment Method Code﻿ 
01
﻿
When success  
amt
N
12
Transaction Amount
10000
﻿
When success
currency
﻿E-Wallet, Payloan﻿
A
3
Currency
IDR
﻿
When success 
payNo
﻿CVS﻿
N
20
﻿
﻿ Number
﻿
goodsNm
﻿E-Wallet, Payloan﻿
AN
100
Goods Name	
Testing Transaction 
﻿ 
﻿
When success
billingNm
﻿E-Wallet, Payloan﻿
A
100
Billing Name
John Doe
﻿
When success
transDt
N
8
Transaction Date (YYYYMMDD)	
20221212
﻿
When success
transTm
N
6
Transaction Time (HH24MISS)	
121212
﻿
When success
description
AN
100
Transaction Description	
Testing 
﻿ Transaction
﻿
When success
authNo
﻿Only CC (Additional)﻿
N
10
Approval Number	
080623
﻿
When success 
issuBankCd
﻿Only CC﻿
A
4
﻿Issuing Bank Code﻿ 
OTHR
﻿
When success 
acquBankCd
﻿Only CC﻿
A
4
﻿Acquiring Bank Code﻿ 
BMRI
﻿
When success

cardNo
﻿Only CC﻿
ANS
20
Card Number with Masking	
453211*****1111
﻿
When success
timestamp
N
14
﻿
﻿ Request Timestamp
20221212121212
﻿
When Success
merchantToken
﻿CC﻿
AN
255
﻿
﻿ Token
2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6
﻿
When Success
cardExpYymm
﻿CC﻿
N
4
Card Expiration (YYMM)
2712
﻿
When Success
instmntMon
﻿CC﻿
N
2
Installment Month 
1: 1 Month/Full 
﻿, jika instmntType: null/1
3: 3 Months
6: 6 Months
12: 12 Months
1
﻿
When Success
instmntType
﻿CC﻿
N
2
﻿Installment Type Code﻿﻿
1
﻿
When Success
ccTransType
﻿CC﻿
AN
2
﻿Credit Card Transaction Type:﻿﻿
1: Normal
2: Recurring
3: Pre-Auth
4: Capture
1
﻿
When Success
recurringToken
﻿Only CC (Additional)﻿
AN
255
Recurring Token
﻿
vat
﻿CC﻿
N
12
Value Added Tax (
﻿)

fee
﻿CC﻿
N
12
Service Fee	

notaxAmt
﻿CC﻿
N
12
Tax Fee Amount	

mitraCd
﻿Direct Debit﻿, E-Wallet, Payloan﻿
A
4
﻿Mitra Code﻿ 
﻿
bankVacctNo
﻿VA﻿
N
20
VA Number	
﻿
Response 
﻿ akan dikirimkan melalui callBackurl dengan  Content-type: application/json dan metode: POST Parameter.
﻿
Sample JSON for CallbackUrl
﻿
URL payment
Response CallBack
{
    "resultCd":"0000",
    "resultMsg":"SUCCESS",
    "tXid":"IONPAYTEST01202212141112221428",
    "referenceNo":"",
    "payMethod":"01",
    "amt":"10000",
    "transDt":"20221212",
    "transTm":"121212",
    "description":"Testing Credit Card Transaction",
    "authNo":"080623",
    "issuBankCd":"OTHR"
    "acquBankCd":"BMRI",
    "cardNo":"453211*****1111",
    "goodsNm":"Test Transaction Nicepay"
    "billingNm":"John Doe",
    "currency":"IDR",
    "timeStamp":"20221212121212",
    "merchantToken":"2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6",
    "cardExpYymm":"2712",
    "instmntMon":"1",
    "instmntType":"1",
    "ccTransType":"1"
}
{
    "resultCd":"0000",
    "resultMsg":"SUCCESS",
    "tXid":"IONPAYTEST01202212141112221428",
    "referenceNo":"",
    "payMethod":"01",
    "amt":"10000",
    "transDt":"20221212",
    "transTm":"121212",
    "description":"Testing Credit Card Transaction",
    "authNo":"080623",
    "issuBankCd":"OTHR"
    "acquBankCd":"BMRI",
    "cardNo":"453211*****1111",
    "goodsNm":"Test Transaction Nicepay"
    "billingNm":"John Doe",
    "currency":"IDR",
    "timeStamp":"20221212121212",
    "merchantToken":"2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6",
    "cardExpYymm":"2712",
    "instmntMon":"1",
    "instmntType":"1",
    "ccTransType":"1"
}
﻿
﻿

CallBack Handling API Checkout 
﻿
Alur CallBack Handling
﻿
tXid tidak akan sama dengan request hold. Proses Capture akan memastikan bahwa nilai amount 
﻿ di-capture tidak melebihi dana 
﻿ dimiliki.
Saat Callback diterima callbackUrl 
﻿, kami sangat menganjurkan 
﻿ untuk melakukan verifikasi Status menggunakan Status Inquiry - API Checkout﻿.
CallBack Handling dapat sangat membantu untuk meminimalisir terjadinya Fraud, kami sangat merekomendasikan 
﻿ untuk melakukan verifikasi CallBack Handling.
﻿

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

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	IONPAYTEST01202212141112221428 When success
referenceNo	ANS	40	Order Number	(empty) When success
payMethod E-Wallet, Payloan	N	2	Payment Method Code	01 When success
amt	N	12	Transaction Amount	10000 When success
currency E-Wallet, Payloan	A	3	Currency	IDR When success
payNo CVS	N	20	Number
goodsNm E-Wallet, Payloan	AN	100	Goods Name	Testing Transaction When success
billingNm E-Wallet, Payloan	A	100	Billing Name	John Doe When success
transDt	N	8	Transaction Date (YYYYMMDD)	20221212 When success
transTm	N	6	Transaction Time (HH24MISS)	121212 When success
description	AN	100	Transaction Description	Testing Transaction When success
authNo Only CC (Additional)	N	10	Approval Number	080623 When success
issuBankCd Only CC	A	4	Issuing Bank Code	OTHR When success
acquBankCd Only CC	A	4	Acquiring Bank Code	BMRI When success
cardNo Only CC	ANS	20	Card Number with Masking	453211*****1111 When success
timestamp	N	14	Request Timestamp	20221212121212 When Success
merchantToken CC	AN	255	Token	2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6 When Success
cardExpYymm CC	N	4	Card Expiration (YYMM)	2712 When Success
instmntMon CC	N	2	Installment Month 1: 1 Month/Full , jika instmntType: null/1 3: 3 Months 6: 6 Months 12: 12 Months	1 When Success
instmntType CC	N	2	Installment Type Code	1 When Success
ccTransType CC	AN	2	Credit Card Transaction Type: 1: Normal 2: Recurring 3: Pre-Auth 4: Capture	1 When Success
recurringToken Only CC (Additional)	AN	255	Recurring Token
vat CC	N	12	Value Added Tax ( )
fee CC	N	12	Service Fee
notaxAmt CC	N	12	Tax Fee Amount
mitraCd Direct Debit, E-Wallet, Payloan	A	4	Mitra Code
bankVacctNo VA	N	20	VA Number

Updated 23 Aug 2024

Did this page help you?

GPN - API Checkout

Status Inquiry - API Checkout

Payment - API Checkout

Menampilkan Payment Page dari PaymentURL

Parameter Format Payment Page

After Payment Handling

Response Parameters (CallbackUrl)

Sample JSON for CallbackUrl

CallBack Handling API Checkout

Selamat Datang di NICEPAY DOCS