---
title: Payment - API Paylater
slug: nicepay-api-non-snap-payment-api-paylater
description: Informasi tentang API Non-SNAP Payment - Payment - API Paylater yang terdapat pada sistem NICEPAY
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/jiT-RNaKmr3EEXQrBcMmL_nicepay-docs-logo.png
icon: {"faIcon":"fa-solid fa-book"}
docTags: 
createdAt: 2022-12-01T07:40:49.000Z
---

# Tentang API Paylater Payment 

***

Melalui metode pembayaran Paylater, NICEPAY menawarkan Anda kemudahan pembayaran lintas aplikasi (*Jump App*) untuk Pelanggan Anda. Notifikasi akan dikirimkan ke Pelanggan secara *real-time* sesaat setelah Pelanggan menyelesaikan pembayaran. Pelanggan akan mendapatkan notifikasi secara berkala terkait pengajuan pinjaman melalui NICEPAY.



# API Paylater Payment

***

API Pembayaran Paylater bertujuan agar Pelanggan Anda dapat menyelesaikan transaksi pembayaran. Tahapan ini digunakan untuk melakukan integrasi sistem Merchant dengan sistem NICEPAY. 



| **API End Point**  | `/nicepay/direct/v2/payment`                                 |
| ------------------ | ------------------------------------------------------------ |
| **Request Method** | <font color="#3b9f0f">**POST**</font>****                    |
| **Description**    | Performs Transaction Regist to NICEPAY&#xD;                  |
| **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) |
| **Request Format** | `application/x-www-form-urlencoded`                          |



Request Parameter for Paylater Payment


***

Berikut ini adalah daftar parameter untuk melakukan integrasi proses *payment* untuk metode pembayaran Paylater. Parameter ini digunakan melalui platform pengujian API sebagai salah satu tahapan supaya sistem milik Merchant dapat terhubung dengan layanan dari NICEPAY. &#x20;

| **Parameter**                                                | **Tipe** | **Ukuran** | **Deskripsi**                          | **Contoh / Catatan**                                             |
| ------------------------------------------------------------ | -------- | ---------- | -------------------------------------- | ---------------------------------------------------------------- |
| `timeStamp` <br /><font color="#2166ae">Required</font>      | N        | 14         | Request Timestamp (`YYYYMMDDHH24MISS`) | 20200910170911                                                   |
| `tXid` <br /><font color="#2166ae">Required</font>           | AN       | 30         | Transaction ID	                        | IONPAYTEST01201804191202084760                                   |
| `merchantToken
`<br /><font color="#2166ae">Required
</font> | AN       | 255        | Merchant Token                         | d27544e13fd9937be9fc5d99ba39a75344b0e6dd1c6c358c9858a94606a74c4e |
| `callBackUrl
`<br /><font color="#2166ae">Required
</font>   | ANS      | 255        | Payment Result URL                     | http\://merchant.com/callbackUrl<br />&#xD;                      |



## Sample JSON for Paylater Payment&#x20;

***

:::CodeblockTabs
FormUrlencoded

```json
callBackUrl=http://merchant.com/callbackUrl
tXid=PAYLOANTES06202010221238593706
timeStamp=20200910170911
merchantToken=d27544e13fd9937be9fc5d99ba39a75344b0e6dd1c6c358c9858a94606a74c4e
```

Java Request

```java
nicePay.setTimeStamp("20200910170911");
nicePay.settXid("PAYLOANTES06202010221238593706");
nicePay.setMerchantToken(nicePay.getMerchantToken());
nicePay.setCallBackUrl("http://merchant.com/callbackUrl");

// Payment Request
nicePay.payment();
```
:::



# CallBack Handling Paylater

***

`Callback Handling` yang didapat pada metode pembayaran Paylater menggunakan URL. Setelah Merchant melakukan pemanggilan API di Paylater, maka Merchant akan langsung dialihkan menuju halaman pembayaran pada aplikasi Partner NICEPAY.

:::hint{type="success"}
Ketika Callback diterima `callbackurl` Anda, NICEPAY merekomendasikan Merchant untuk melakukan verifikasi status dengan menggunakan [Status Inquiry - API Paylater](docId\:r6YyG1qEKKLzWnVhazxCV).&#x20;
:::

:::hint{type="warning"}
`CallBack Handling` sangat penting untuk membantu meminimalisir tindakan *Fraud*. NICEPAY sangat merekomendasikan Merchant untuk melakukan verifikasi menggunakan `CallBack Handling`.
:::

:::CodeblockTabs
URL CallBack

```json
https://merchant.co.id/nicepay-callback?resultCd=0000&resultMsg=SUCCESS&tXid=PAYLOANTES06202212141336161529&referenceNo=815123412341&payMethod=06&amt=20000&transDt=20221214&transTm=133616&description=&authNo=&issuBankCd=&acquBankCd=&cardNo=&receiptCode=&mitraCd=KDVI&recurringToken=&preauthToken=&currency=IDR&goodsNm=Test+Transaction+Nicepay&billingNm=Customer +Name&ccTransType=&mRefNo=&instmntType=&instmntMon=&cardExpYymm=&issuBankNm=&acquBankNm=&timeStamp=&merchantToken=
```

Response CallBack

```none
{
    "resultCd": "0000",
    "resultMsg": "SUCCESS",
    "tXid": "PAYLOANTES06202212141336161529",
    "referenceNo": "815123412341",
    "payMethod": "06",
    "amt": "20000",
    "transDt": "20221214",
    "transTm": "133616",
    "description": "",
    "authNo": "",
    "issuBankCd": "",
    "acquBankCd": "",
    "cardNo": "",
    "receiptCode": "",
    "mitraCd": "KDVI",
    "recurringToken": "",
    "preauthToken": "",
    "currency": "IDR",
    "goodsNm": "Test Transaction Nicepay",
    "billingNm": "Customer Name",
    "ccTransType": "",
    "mRefNo": "",
    "instmntType": "",
    "instmntMon": "",
    "cardExpYymm": "",
    "issuBankNm": "",
    "acquBankNm": "",
    "timeStamp": "",
    "merchantToken": ""
}
```
:::



# Confirm Receipt (Hanya Akulaku)

***

:::hint{type="warning"}
Hanya lakukan proses ini setelah Pelanggan telah menerima barang. Merchant wajib melakukan ini untuk mendapatkan dana settlement dari transaksi yang sudah dilakukan.
:::

| **API End Point**  | `/nicepay/api/direct/v2/confirmAkulaku`                               |
| ------------------ | --------------------------------------------------------------------- |
| **Request Method** | <font color="#3b9f0f">**POST**</font>****                             |
| **Description**    | Melakukan konfirmasi *receipt&#x20;*&#x75;ntuk dana *settlement*&#xD; |
| **Merchant Token** | SHA256(`timeStamp`+`tXid`+`iMid`+`merchantKey`)                       |



## Request Parameter

| **Parameter**                                                | **Tipe** | **Ukuran** | **Deskripsi**                          | **Contoh / Catatan**           |
| ------------------------------------------------------------ | -------- | ---------- | -------------------------------------- | ------------------------------ |
| `timeStamp `<br /><font color="#2166ae">Required</font>      | N        | 14         | Request Timestamp (`YYYYMMDDHH24MISS`) | 20170708123456                 |
| `tXid `<br /><font color="#2166ae">Required</font>           | AN       | 30         | Transaction ID	                        | IONPAYTEST02201607291027025291 |
| `iMid`<br /><font color="#2166ae">Required
</font>           | AN       | 10         | Merchant ID                            | IONPAYTEST                     |
| `merchantToken
`<br /><font color="#2166ae">Required
</font> | AN       | 255        | Merchant Token                         | 6cfccfc0046773c1b589d8e98f8    |



## Response Parameter

| **Parameter**                                               | **Tipe** | **Ukuran** | **Deskripsi**                                  | **Contoh / Catatan** |
| ----------------------------------------------------------- | -------- | ---------- | ---------------------------------------------- | -------------------- |
| `resultCd`<br /><font color="#2166ae">Required</font>       | N        | 4          | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM)    |                      |
| `resultMsg`<br /><font color="#2166ae">Required</font>      | AN       | 30         | [Result Message](docId\:gvAdBBr0SQ92N1zHplSFM) |                      |
| `ResponseData
`<br /><font color="#2166ae">Required
</font> | AN       | 255        | Merchant Token                                 |                      |