Payment - API Checkout
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.
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.
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 |
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.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
|---|---|---|---|---|
resultCd | N | 4 | 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 | 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 | OTHR When success | |
acquBankCd Only CC | A | 4 | 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 | 1 When Success | |
ccTransType CC | AN | 2 | 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 | | |
bankVacctNo VA | N | 20 | VA Number | |
Response akan dikirimkan melalui callBackurl dengan Content-type: application/json dan metode: POST Parameter.
- 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.