---
title: Payment - API Checkout
slug: nicepay-api-payment-api-checkout
description: Informasi tentang API Checkout - Payment untuk semua metode pembayaran yang disediakan oleh NICEPAY
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/rzlOA_uX2BAzMrnC_9r4N_nicepay-docs-logo.png
icon: {"faIcon":"fa-solid fa-book"}
docTags:
createdAt: 2022-09-21T02:54:45.000Z
---
# Menampilkan Payment Page dari PaymentURL
***
Ketika Anda berhasil mendaftarkan *request* transaksi pada [Registration - API Checkout](docId:1y_mEI3eZUS-XW2YPhGyp), Anda akan mendapatkan *response *berupa `paymentURL`. Untuk menampilkan *payment page *di sisi 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](docId:1y_mEI3eZUS-XW2YPhGyp).
Perhatikan contoh berikut ini.
```none
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 transaksi yang Anda ajukan sudah bisa dibayarkan oleh Pelanggan. Anda hanya perlu menampilkan tautan atau *embedded link* tersebut pada *website* yang Anda miliki.
:::hint{type="warning"}
Untuk metode pembayaran E-Wallet ShopeePay dan OVO, kami sarankan agar Pelanggan Anda membuka halaman pembayaran melalui perangkat ponsel yang dimiliki.
:::
# Parameter Format Payment Page
| **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 |
# After Payment Handling
***
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](docId:1y_mEI3eZUS-XW2YPhGyp).
:::hint{type="info"}
Silakan kunjungi halaman [Notification - API Checkout](docId:0BfdvETd5MPDBAkFzIVBE) untuk mendapatkan informasi lebih detail mengenai `dbProcessURL`.
:::
## Response Parameters (CallbackUrl)
| **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** |
| -------------------------------------------------------------------------------------------------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 |
| `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | 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](docId\:g7inRV70XcSA9lP7bpmok) | 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 | [Issuing Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | OTHR
When success |
| `acquBankCd`
Only CC | A | 4 | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | 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 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 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 (VAT) |
|
| `fee`
CC | N | 12 | Service Fee |
|
| `notaxAmt`
CC | N | 12 | Tax Fee Amount |
|
| `mitraCd`
Direct Debit, E-Wallet, Payloan | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | |
| `bankVacctNo`
VA | N | 20 | VA Number | |
:::hint{type="info"}
Response parameter akan dikirimkan melalui `callBackurl` dengan Content-type: `application/json` dan metode: `POST Parameter`.
:::
## Sample JSON for CallbackUrl
***
:::CodeblockTabs
URL payment
```json
https://nicepay.co.id/nicepay/redirect/v2/payment?tXid=IONPAYTEST00202203211640309389
```
Response CallBack
```json
{
"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
------------------------------------
***
::Image[]{src="https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/eMkBILN_IdNLFXTXs64K9_nicepay-api-checkout-api-callback-handling-flowdrawio-2.png" size="50" width="370" height="361" caption="Alur CallBack Handling" position="center" darkWidth="370" darkHeight="361" showCaption="true"}
:::hint{type="info"}
- `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](docId\:K9vBS87ev9_w5oJAU0et3).
- `CallBack Handling` dapat sangat membantu untuk meminimalisir terjadinya *Fraud*, kami sangat merekomendasikan Merchant untuk melakukan verifikasi `CallBack Handling`.
:::