---
title: Paylater - API Checkout
slug: nicepay-api-paylater-payment-api-checkout
description: Informasi tentang API Checkout - Payment untuk metode pembayaran Paylater yang disediakan oleh NICEPAY
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/7rv7sCN9VlHaGwuaOCRs__rdrx9d8diazpgm07xfz2test-1.png
icon: {"faIcon":"fa-solid fa-credit-card"}
docTags:
createdAt: 2022-12-19T10:12:06.000Z
---
# Tentang Paylater - API Checkout
***
API ini digunakan oleh Merchant untuk melakukan pengajuan pembayaran kepada NICEPAY untuk metode pembayaran Paylater menggunakan Checkout API.
# Alur Proses
***
Deskripsi langkah pembayaran dengan Paylater:
1. Pelanggan *request checkout* kepada Merchant.
2. Merchant mengirimkan API Registration kepada NICEPAY.
3. Pada bagian *Registration;*
- Jika menggunakan Akulaku:
- NICEPAY akan *request *pesanan kepada Akulaku selaku Paylater Partner.
- Akulaku akan *generate *pesanan.
- Akulaku mengirimkan *response *data kepada NICEPAY.
- NICEPAY akan mengirimkan *capture response *API Regist kepada Merchant.
- Jika menggunakan Kredivo/Indodana:
- NICEPAY akan menyimpan order regist*.*
- NICEPAY akan mengirimkan *response *order regist.
4. Merchant mengirimkan API Payment kepada NICEPAY.
5. Kemudian pada bagian *Payment;*
- Jika menggunakan Akulaku:
- NICEPAY mengarahkan Pelanggan kepada halaman Akulaku.
- Pelanggan melakukan *login *akun.
- Pelanggan melakukan konfirmasi pembayaran kepada Akulaku selaku Paylater Partner.
- Akulaku melakukan validasi pembayaran.
- Akulaku mengalihkan Pelanggan dengan *callbackUrl.*
- Jika menggunakan Kredivo/Indodana:
- NICEPAY *request checkout* kepada Paylater Partner.
- Paylater Partner melakukan proses checkout.
- Paylater Partner mengirim *response *dan mengalihkan ke halaman milik Paylater Partner.
- Pelanggan melakukan konfirmasi pembayaran kepada Paylater Partner.
- Paylater Partner mengirimkan OTP kepada Pelanggan.
- Pelanggan memasukkan OTP kepada Paylater Partner.
- Paylater Partner melakukan validasi OTP.
- Paylater Partner melakukan konfirmasi hasil pesanan kepada Pelanggan.
6. Pada bagian *Notification;*
- Jika menggunakan Akulaku:
- Akulaku selaku Paylater Partner mengirimkan *push capture notif *kepada NICEPAY.
- NICEPAY menyimpan notifikasi.
- NICEPAY mengirimkan *capture update notification *kepada Merchant.
- Merchant menampilkan *response *kepada Pelanggan.
- Jika menggunakan Kredivo/Indodana:
- Paylater Partner mengirimkan *push notification *kepada NICEPAY.
- NICEPAY melakukan validasi terhadap notifikasi yang diterima.
- NICEPAY mengajukan konfirmasi pesanan.
- Paylater Partner melakukan konfirmasi proses pesanan.
- Paylater Partner mengirim data konfirmasi pesanan kepada NICEPAY.
- NICEPAY mengirimkan hasil konfirmasi pesanan.
7. Jika Paylater Partner yang digunakan adalah Akulaku, Pelanggan dapat melakukan konfirmasi bukti pembayaran:
- Pelanggan mengirimkan konfirmasi bukti pembayaran kepada Merchant.
- Merchant mengajukan konfirmasi bukti pembayaran kepada NICEPAY.
- NICEPAY mengajukan proses konfirmasi bukti pembayaran kepada Akulaku.
- Akulaku melakukan proses konfirmasi bukti pembayaran.
- Akulaku mengirim *response *data kepada NICEPAY.
- NICEPAY mengirim *response *data kepada Merchant.
- Merchant menampilkan hasil data kepada Pelanggan.
8. Merchant mengajukan pemeriksaan status menggunakan API Status kepada NICEPAY.
9. NICEPAY mengirimkan *response *pemeriksaan status.
10. Merchant menerima status terakhir.
11. Merchant mengirimkan status konfirmasi kepada Pelanggan.
# NICEPAY Secure Payment Page
***
Gambar di bawah adalah contoh Checkout pembayaran dengan metode Paylater menggunakan NICEPAY Secure Payment Page.
Setelah proses *request* registrasi pembayaran selesai, Anda dapat melanjutkan proses transaksi sampai dengan penyelesaian dengan mengikuti panduan pada halaman [Panduan Bayar Paylater](docId\:P8AvV0TcLlEVuI80Pc7Rc).
# API Checkout Transaction Payment
***
| **API URL** | `/nicepay/redirect/v2/payment`
|
| ------------------- | ------------------------------------------- |
| **Request Method** | `Redirect-GET` |
| **Header** | `Content-Type: application/Form-UrlEncoded` |
## Request Parameter for Paylater - API Checkout (CallbackUrl)
***
Berikut adalah daftar Request Parameter untuk API Payment Paylater pada Checkout API.
:::hint{type="warning"}
Catatan untuk Paylater, silakan berikan pesan peringatan kepada Pelanggan untuk membuka melalui perangkat ponsel demi memberikan pengalaman lebih baik kepada Pelanggan.
:::
| **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** |
| --------------------------------------------------------- | -------- | ---------- | --------------------- | ----------------------------------------------------------- |
| `paymentURL`
Required | ANS | 14 | Payment URL
| https\://dev.nicepay.co.id/nicepay/redirect/v2/payment
|
| `tXid`
Required | AN | 30 | Transaction ID
| PAYLOANTES00202212201645434449 |
## Response Parameter for Paylater - API Checkout (CallbackUrl)
***
:::hint{type="info"}
Catatan: Response parameter akan dikirimkan melalui `callBackurl` dengan Content-type: `application/json` dan metode: `POST Parameter`.
:::
| **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 | PAYLOANTES00202212201645434449
When Success |
| `referenceNo` | ANS | 40 | Order Number | ORD20221220161200
When Success |
| `payMethod`
E-Wallet, Paylater | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 06
When Success |
| `amt` | N | 12 | Transaction Amount | 10000
When Success |
| `currency`
E-Wallet, Paylater | A | 3 | Currency | IDR
When Success |
| `goodsNm`
E-Wallet, Paylater | AN | 100 | Goods Name | John+Doe
When Success |
| `billingNm`
E-Wallet, Paylater | 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](docId:1U7QOax_wrzXMoCG-Mqad)
| When Success |
| `acquBankCd`
Only CC | A | 4 | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | When Success |
| `issuBankNm`
Only CC | A | 255 | Issuing Bank Name | When Success |
| `acquBankNm`
Only CC | A | 255 | Acquiring Bank 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, Paylater | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | 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](docId:7CIX-U_4z295XgtNVEsbO) | When Success |
| `instmntMon` | N | 2 | Installment Month
`1`: 1 Month/Full Payment, jika `instmntType`*:* *null/1*
`3`: 3 Months
`6`: 6 Months
`12`: 12 Months | When Success |
| `timeStamp` | N | 14 | API Request Timestamp | When Success |
| `merchantToken` | AN | 255 | Merchant Token | When Success |
Sample Parameter for Paylater - API Checkout (CallbackUrl)
----------------------------------------------------------
***
:::hint{type="success"}
Pada pembayaran saat *Checkout*, *response* dari *request* yang di-*hit* adalah Callback URL.
:::
### Request Parameter
:::CodeblockTabs
cURL
```curl
curl -X GET "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=¤cy=IDR&goodsNm=John+Doe&billingNm=John+Doe&ccTransType=&mRefNo=&instmntType=&instmntMon=&cardExpYymm=&issuBankNm=&acquBankNm=&timeStamp=&merchantToken="
```
:::
### Callback Parameter
:::CodeblockTabs
Response Callback
```curl
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
***
:::hint{type="success"}
Saat *Callback* diterima `callbackUrl` Anda, kami merekomendasikan Merchant untuk melakukan verifikasi Status dengan menggunakan [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3).
:::
:::hint{type="warning"}
`Callback Handling` sangat penting untuk membantu meminimalisir tindakan *Fraud*. Kami sangat merekomendasikan Merchant untuk melakukan verifikasi menggunakan `Callback parameter`.
:::
::Image[]{src="https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/hB3AyDaMVCRKhlIgcs-V4_nicepay-api-checkout-api-callback-handling-flow-1.png" size="50" width="370" height="361" position="center" caption="Alur Callback Handling" alt="Alur Callback Handling" darkWidth="370" darkHeight="361" showCaption="true"}
:::CodeblockTabs
URL Callback
```json
https://merchant.com/api/callBackUrl
```
Response Callback
```json
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=
```
:::