Payment - API Checkout
Ketika Anda berhasil mendaftarkan request transaksi pada Registration - API Checkout, Anda akan mendapatkan response berupa paymentURL. Untuk menampilkan payment page disisi Front-end, Anda diperlukan untuk melakukan mapping paymentURL tersebut terlebih dahulu dengan tambahan parameter pada URL nya, yaitu ?tXid= dan dilengkapi dengan txid yang didapat pada response Registration - API Checkout.
Perhatikan contoh berikut ini:
Ketika Payment Page tersebut sudah sesuai, maka transaksi yang Anda ajukan sudah bisa dibayarkan oleh Pelanggan. Anda hanya perlu menampilkan tautan atau embedded link tersebut pada website yang Anda miliki.
Untuk metode pembayaran E-Wallet ShopeePay dan OVO, kami sarankan agar Pelanggan Anda membuka halaman pembayarannya melalui perangkat ponsel yang dimiliki.
![Halaman Pembayaran Berhasil Halaman Pembayaran Berhasil](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/qRcpEzhxJymcn-WztW6Nz_id-new-secure-payment-page-payloan-3.png?format=webp)
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
paymentURL Required | ANS | 14 | Payment URL | https://nicepay.co.id/nicepay/redirect/v2/payment |
tXid Required | AN | 30 | Transaction ID | IONPAYTEST00202203211640309389 |
Setelah transaksi sudah berhasil dilakukan oleh Pelanggan Anda, notifikasi mengenai status transaksi tersebut, berhasil maupun gagal, akan terkirim secara otomatis ke sistem Anda melalui parameter callbackURL dan dbProcessURL yang Anda masukkan pada saat request melalui Registration - API Checkout.
Silakan kunjungi halaman Notification - API Checkout untuk mendapatkan informasi 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 | Payment Number | |
goodsNm E-Wallet, Payloan | AN | 100 | Goods Name | Testing Transaction Nicepay 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 Credit Card 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 | API Request Timestamp | 20221212121212 When Success |
merchantToken CC | AN | 255 | Merchant Token | 2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6 When Success |
cardExpYymm CC | N | 4 | Card Expiration (YYMM) | 2712 When Success |
instmntMon CC | N | 2 | Installment Month 1: 1 Month/Full Payment, 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 (VAT) |
|
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 parameter akan dikirimkan melalui callBackurl dengan Content-type: application/json dan metode: POST Parameter.
![Alur CallBack Handling Alur CallBack Handling](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/eMkBILN_IdNLFXTXs64K9_nicepay-api-checkout-api-callback-handling-flowdrawio-2.png?format=webp)
- tXid tidak akan sama dengan request hold. Proses Capture akan memastikan bahwa nilai amount yang di-capture tidak melebihi dana yang dimiliki.
- Saat Callback diterima callbackUrl Anda, kami sangat menganjurkan Merchant untuk melakukan verifikasi Status menggunakan Status Inquiry - API Checkout.
- CallBack Handling dapat sangat membantu untuk meminimalisir terjadinya Fraud, kami sangat merekomendasikan Merchant untuk melakukan verifikasi CallBack Handling.