---
title: Seamless - Registration API Paylater
slug: en/nicepay-api-non-snap-seamless-registration-api-paylater
description: Informasi tentang API Non-SNAP Payment - Seamless - Registration API Paylater yang terdapat pada sistem NICEPAY
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/VbX3018IlgBlLVm3GGCl6_nicepay-docs-logo.png
icon: {"faIcon":"fa-solid fa-book"}
docTags: 
createdAt: 2026-01-23T07:09:02.025Z
---

# About Seamless - Registration API Paylater

***

Seamless type transaction is a Paylater service owned by NICEPAY that provides a faster and more efficient paylater and installment payment experience. Through this service, users can link their accounts with Merchants without needing to performs transaction authentication beforehand, such as logging in, during the payment. Therefore, every transaction between Customers and Merchants can run efficiently without re-authenticating the user account login steps with security that remain protected and reliable by NICEPAY.

:::hint{type="info"}
Currently, only Kredivo which already supports the Seamless feature.
:::

There are 2 steps to activates a transaction with Seamless type, which are:

1. Performs the Customer 's data tokenization by making a transaction first.
2. Using the [Registration & Notification - Account Binding Paylater API](docId:9YJCSWxz6SGWUKulYfzrw) feature.

This page explain the Customer's data tokenization on first payment process deeper, so that the Seamless feature can be used on the next transaction.



# Process Flow

***

## Tokenize

### Tokenize With Transaction

![Tokenize with Transaction](https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/vvlXOpdEIQ3r5gP5ZLOP-_diagram-seamless-payment-api-paylater-tokenize-with-transaction.jpg "Tokenize with Transaction")

Flow description:

1. The Customer does checkout.&#x20;
2. The Customer requests a checkout to the Merchant
3. The Merchant requests a checkout to NICEPAY.
4. NICEPAY requests a checkout to the Paylater Partner.&#x20;
5. The Paylater Partner registers the checkout.
6. The Paylater Partner sends a response to NICEPAY.
7. NICEPAY sends a redirect URL to the Merchant.
8. The Merchant redirects  the Customer to the Partner's page.
9. The Customer do logins through the Partner Login Page.
10. The Customer mengirimkan kredensial kepada the Paylater Partner.
11. The Paylater Partner melakukan validasi pembayaran.
12. During the transaction process:
    - If the transaction is approved, then:
      - The Paylater Partner processes the approval.
      - The Paylater Partner sends an approval result to NICEPAY.
      - NICEPAY receives the approval result.
      - NICEPAY sends the approval result to the Merchant.
      - The Merchant receives the approval result notification.
      - The Merchant request a status to NICEPAY.
      - NICEPAY checks the status.
      - NICEPAY sends a status result to the Merchant.
      - The Merchant receives the final status.
      - The Merchant sends a notification status to the Customer.
      - The Customer receives the approval result.
    - If the transaction is still processing:
      - The Paylater Partner directs  the Customer to the Merchant/NICEPAY page.
      - The Merchant/NICEPAY page will be shown to the Customer.
      - The Customer waiting for approval.



### Tokenize Without Transaction

![Tokenize without Transaction](https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/l8UDhrC12AHMaddXNdn-i_diagram-seamless-payment-api-paylater-tokenize-without-transaction.jpg "Tokenize without Transaction")

Flow description:

1. The Customer submits a phone number to the Merchant.
2. The Merchant requests an account binding to NICEPAY.
3. NICEPAY requests an account binding to the Paylater Partner.
4. The Paylater Partner performs validation.
5. The Paylater Partner sends a response to NICEPAY.
6. NICEPAY returns the redirects URL to the Merchant.
7. The Merchant redirects the Customer to the Partner's page.
8. The Customer do logins through the Partner Login Page.
9. The Customer sends a credential to the Paylater Partner.
10. The Paylater Partner performs login validation.
11. The Paylater Partner returns an OTP to the Customer.
12. The Customer inputs the OTP to the Paylater Partner.
13. The Paylater Partner generates a User Token.
14. The Paylater Partner directs the Customer to the Merchant/NICEPAY page.
15. During the account binding process:
    - On the Customer's section:
      - The Merchant/NICEPAY page will be shown to the Customer.
      - The Customer waiting for approval.
    - From the Notification section:
      - Paylater Partner sends a notification to the NICEPAY.
      - NICEPAY receives the notification.
      - NICEPAY sends a notification to the Merchant.
      - The Merchant receives the notification.
      - The Merchant displays the account binding result to the Customer.



## Deactivate Tokenize

:::hint{type="info"}
Please visit the [Deactivate - Account Binding Paylater API](docId\:ZT-lpMhDWGIjDy3j1_NFt) page for further informationabout the user token inactivation process with Seamless feature.
:::



Tokenize - Registration API Paylater (First Payment)
====================================================

***

| **API Endpoint**   | `nicepay/direct/v2/registration`                                          |
| ------------------ | ------------------------------------------------------------------------- |
| **Request Method** | <font color="#3b9f0f">**POST**</font>****                                 |
| **Description**    | Create user token                                                         |
| **Merchant Token** | **SHA256&#x20;**(`iMid` + `referenceNo` + `billingPhone` + `merchantKey`) |
| **Request Format** | `application/JSON`                                                        |



## Request Parameter for Tokenize - Registration API Paylater (First Payment)

***

| **Parameter**                                                                        | **Type**           | **Length** | **Description**                                                                                                           | **Example / Notes**                                                                                                                                                                                                                                                                                                                                                                                                                                                           |                              |
| ------------------------------------------------------------------------------------ | ------------------ | ---------- | ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- |
| `timeStamp `<br /><font color="#2166ae">Required</font>                              | N                  | 14         | Request Timestamp (`YYYYMMDDHH24MISS`)                                                                                    | 20220131125959                                                                                                                                                                                                                                                                                                                                                                                                                                                                |                              |
| `iMid `<br /><font color="#2166ae">Required</font>                                   | AN                 | 10         | Merchant ID	<br />                                                                                                        | PAYLOANTES                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                              |
| `payMethod`<br /><font color="#2166ae">Required</font>                               | N                  | 2          | [Payment Method Code](docId\:IifMsRUUw7j9VMWeFJz97) <br />                                                                | 06&#xD;                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |                              |
| `currency`<br /><font color="#2166ae">Required</font>                                | A                  | 3          | Currency<br />                                                                                                            | IDR                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |                              |
| `amt` <br /><font color="#2166ae">Required</font>                                    | N                  | 12         | Amount<br />                                                                                                              | 10000                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                              |
| `referenceNo`<br /> <font color="#2166ae">Required</font>                            | ANS                | 40         | Merchant's Reference Number<br />                                                                                         | ORD12345                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |                              |
| `callBackUrl`                                                                        | ANS                | 255        | Payment Result URL                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |                              |
| `goodsNm `<font color="#2166ae"> </font><br /><font color="#2166ae">Required</font>  | AN                 | 100        | Goods Name	<br />                                                                                                         | Test Transaction NICEPAY&#xD;                                                                                                                                                                                                                                                                                                                                                                                                                                                 |                              |
| `billingNm `<br /><font color="#2166ae">Required</font>                              | A                  | 100        | Buyer Name	<br />                                                                                                         | John Doe&#xD;                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |                              |
| `billingPhone`<br /><font color="#2166ae">Required</font>                            | N                  | 15         | Buyer Phone Number	<br />                                                                                                 | 08123456789                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |                              |
| `billingEmail`<br /><font color="#2166ae">Required</font>                            | ANS                | 40         | Buyer E-Mail	<br />                                                                                                       | email\@merchant.com                                                                                                                                                                                                                                                                                                                                                                                                                                                           |                              |
| `billingAddr`<br /> <font color="#2166ae">Required</font>                            | AN                 | 100        | Buyer Address	<br />                                                                                                      | Jalan Bukit Berbunga 22&#xD;                                                                                                                                                                                                                                                                                                                                                                                                                                                  |                              |
| `billingCity`<br /><font color="#2166ae">Required</font>                             | A                  | 50         | Buyer City	<br />                                                                                                         | Jakarta&#xD;                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |                              |
| `billingState`<br /><font color="#2166ae">Required</font>                            | A                  | 50         | Billing State	<br />                                                                                                      | DKI Jakarta&#xD;                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                              |
| `billingPostCd `<br /><font color="#2166ae">Required</font>                          | N                  | 10         | Billing Post Number	<br />                                                                                                | 12345                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                              |
| `billingCountry `<br /><font color="#2166ae">Required</font>                         | A                  | 10         | Billing Country	<br />                                                                                                    | Indonesia                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |                              |
| `cartData `<br /><font color="#2166ae">Required</font>                               | `JSONstring`<br /> | 4000       | Cart Data<br />                                                                                                           | \{"count":3,"item":\[\{"goods\_id":30,"goods\_name":"Beanie","goods\_type":"Accessories","goods\_amt":5000,"goods\_sellers\_id":"NICEPAY-NamaMerchant","goods\_sellers\_name":"NICEPAYSHOP","goods\_quantity":1,"goods\_url":"[http://www.nicestore.com/product/beanie/](http://www.nicestore.com/product/beanie/)"},..]}                                                                                                                                                     |                              |
| `userIP `<br /><font color="#2166ae">Required for CC, E-Wallet, Paylater,QRIS</font> | AN                 | 15         | User IP<br />                                                                                                             | 127.0.0.1&#xD;<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                              |
| `dbProcessUrl`<br /> <font color="#2166ae">Required</font>                           | ANS                | 255        | Notification URL	<br />                                                                                                   | https\://merchant.com/dbProcessUrl&#xD;                                                                                                                                                                                                                                                                                                                                                                                                                                       |                              |
| `merchantToken`<br /><font color="#2166ae">Required</font>                           | AN                 | 255        | Merchant Token	<br />                                                                                                     | 9b38b12e83b6ee124d4b549238f232c6179b168effc4ffb7f64d00c15f08e230                                                                                                                                                                                                                                                                                                                                                                                                              |                              |
| `deliveryNm`<br /><font color="#2166ae">Required</font>                              | A                  | 30         | Delivery Name	                                                                                                            | email\@merhchant.com                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                              |
| `deliveryPhone`<br /><font color="#2166ae">Required</font>                           | N                  | 15         | Delivery Phone	                                                                                                           | 08123456789                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |                              |
| `deliveryAddr`<br /><font color="#2166ae">Required</font>                            | AN                 | 100        | Delviery Address	                                                                                                         | Jalan Bukit Berbunga 22                                                                                                                                                                                                                                                                                                                                                                                                                                                       |                              |
| `deliveryCity`<br /><font color="#2166ae">Required</font>                            | A                  | 50         | Delivery City	                                                                                                            | Jakarta                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |                              |
| `deliveryState`<br /><font color="#2166ae">Required</font>                           | A                  | 50         | Delivery State	                                                                                                           | DKI Jakarta                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |                              |
| `deliveryPostCd`<br /><font color="#2166ae">Required</font>                          | N                  | 10         | Delivery Post Code	                                                                                                       | 12345                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                              |
| `deliveryCountry`<br /><font color="#2166ae">Required</font>                         | A                  | 10         | Delivery Country	                                                                                                         | Indonesia                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |                              |
| `mitraCd`<br /><font color="#2166ae">Required</font>                                 | N                  | 2          | [Mitra Code](docId\:Tm257gq3DxgZf98uZ0l33)                                                                                | KDVI                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                              |
| `instmntType`<br /><font color="#2166ae">Required</font>                             | N                  | 8          | [Installment Type Code](docId\:RT2C32S9hfl_aOhYoebv5)                                                                     | 2                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |                              |
| `instmntMon`<br /><font color="#2166ae">Required</font>                              | N                  | 6          | `1`: 1 Month/Full Payment, *if instmntType:* *null/1*<br />`3`: 3 Months <br />`6`: 6 Months <br />`12`: 12 Months<br />  | 3                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |                              |
| `userSessionID`                                                                      | AN                 | 255        | ID User Session                                                                                                           | 697D6922C961070967D3BA1BA5699C2C                                                                                                                                                                                                                                                                                                                                                                                                                                              |                              |
| `userAgent`                                                                          | ANS                | 255        | User Agent                                                                                                                | Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/60.0.3112.101 Safari/537.36                                                                                                                                                                                                                                                                                                                                                            |                              |
| `userLanguage`                                                                       | ANS                | 255        | User Language                                                                                                             | ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4                                                                                                                                                                                                                                                                                                                                                                                                                                           |                              |
| `sellers`<br /><font color="#2166ae">Required</font>                                 | `JSON String`      | 4000       | Seller Data                                                                                                               | \[\{\\"sellersId\\":\\"NICEPAY-NamaMerchant\\",\\"sellersNm\\":\\"NICEPAYSHOP\\",\\"sellersUrl\\":\\"http\://nicestore.store/product/beanie/\\",\\"sellersEmail\\":\\"Nicepay\@nicepay.co.id\\",\\"sellersAddress\\":\{\\"sellerNm\\":\\"NICEPAYSHOP\\",\\"sellerLastNm\\":\\"NICEPAYSHOP\\",\\"sellerAddr\\":\\"Jln. Kasablanka Kav 88\\",\\"sellerCity\\":\\"Jakarta\\",\\"sellerPostCd\\":\\"14350\\",\\"sellerPhone\\":\\"082111111111\\",\\"sellerCountry\\":\\"ID\\"}}] |                              |
| `tokenizeUser`<br /><font color="#2166ae">Required</font>                            | N                  | 1          | Seamless Paylater                                                                                                         | Transaction Tokenize Type:<br />`0`: Normal<br />`1`: Tokenize (First Transaction)<br />`2`: Seamless (Next Payment)                                                                                                                                                                                                                                                                                                                                                          | 1                            |
| `clientUserKey`<br /><font color="#2166ae">Required</font>                           | AN                 | 100        | Seamless Paylater<br />(Mandatory)                                                                                        | User Key, must be unique for each Customer.                                                                                                                                                                                                                                                                                                                                                                                                                                   | Gili.heriawan\@nicepay.co.id |



## Response Parameter for Tokenize - Registration API Paylater (First Payment)

***

| **Parameter**   | **Tipe** | **Ukuran** | **Deskripsi**                                               | **Contoh / Catatan**                                                                                                                                                                                  |
| --------------- | -------- | ---------- | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `resultCd`      | N        | 4          | [Result Code](docId:7o8Nl7guqp_asiwFdqi3v)                  | 0000                                                                                                                                                                                                  |
| `resultMsg`     | AN       | 255        | Result Message: [Error Code](docId\:wpcEMaZro_Xvnxz-1ZAiB)  | SUCCESS                                                                                                                                                                                               |
| `tXid`          | AN       | 30         | Transaction ID (Key from NICEPAY)                           | IONPAYTEST02201607291027025291                                                                                                                                                                        |
| `referenceNo`   | ANS      | 40         | Merchant Order Number (Key from Merchant)                   | OrdNo20160525000-52104                                                                                                                                                                                |
| `payMethod`     | N        | 2          | [Payment Method Code](docId\:IifMsRUUw7j9VMWeFJz97)         | 06                                                                                                                                                                                                    |
| `amt`           | N        | 12         | Payment Amount                                              | 1000                                                                                                                                                                                                  |
| `currency`      | AN       | 3          | Currency                                                    | IDR                                                                                                                                                                                                   |
| `goodsNm`       | AN       | 100        | Goods Name                                                  | Merchant Goods 1                                                                                                                                                                                      |
| `billingNm`     | A        | 30         | Buyer Name                                                  | Buyer Name                                                                                                                                                                                            |
| `transDt`       | N        | 8          | Transaction Date (`YYYYMMDD`)                               | 20160303                                                                                                                                                                                              |
| `transTm`       | N        | 6          | Transaction Time (`HH24MISS`)                               | 135959                                                                                                                                                                                                |
| `description`   | AN       | 100        | Transaction Description                                     | Payment of OrdNo20160525000-52104                                                                                                                                                                     |
| `bankCd`        | A        | 4          | [Bank Code](docId\:kY4pPuJOT06aTnIE_EAsF)                   | BMRI                                                                                                                                                                                                  |
| `vacctNo`       | N        | 20         | Virtual Account Number                                      | 123457891011                                                                                                                                                                                          |
| `vacctValidDt`  | N        | 8          | VA Expiry Date (`YYYYMMDD`)                                 | 20160303                                                                                                                                                                                              |
| `vacctValidTm`  | N        | 6          | VA Expiry Time (`HH24MISS`)                                 | 135959                                                                                                                                                                                                |
| `mitraCd`       | AN       | 4          | [Mitra Code](docId\:Tm257gq3DxgZf98uZ0l33)                  | KDVI                                                                                                                                                                                                  |
| `payNo`         | N        | 12         | CVS Number                                                  | 123456789012                                                                                                                                                                                          |
| `payValidDt`    | N        | 8          | CVS Expiry Date (`YYYYMMDD`)                                | 20170313                                                                                                                                                                                              |
| `payValidTm`    | N        | 6          | CVS Expiry Time (`HH24MISS`)                                | 135959                                                                                                                                                                                                |
| `paymentExpDt`  | N        | 6          | QR Payment Expiry Date (`YYYYMMDD`)                         | 20201005                                                                                                                                                                                              |
| `paymentExpTm`  | N        | 6          | QR Payment Expiry Time (`HH24MISS`)                         | 124354                                                                                                                                                                                                |
| `qrContent`     | ANS      | 360        | QR String in Plain Text                                     | 00020101021226590016ID.CO.SHOPEE.WWW011893600918000041566602064156660303UME52045399530336054045.005802ID5913NICEPAY dummy6015KOTA JAKARTA SE61051287062360520082020100512385458400708T000000163044A04 |
| `qrUrl`         | ANS      | 360        | URL for QR Image, Valid for 5 Minutes.                      | https\://api.wallet.airpay.co.id/v3/merchant-host/qr/download?qr=wOCiKheIXwgyjnUUk6PhJLTS1e9Ros7zf0ESj6AavQ                                                                                           |
| `clientUserKey` | AN       | 100        | User Key, must be unique for each Customer.                 | gili.heriawan\@nicepay.co.id                                                                                                                                                                          |

:::hint{type="info"}
After the Customer successfully make transaction payment with tokenization, Merchant will obtain a `userToken` parameter from [Notification - API Paylater](docId\:S6hf8yM1-SQ0qMTGLZWGy) regarding the success payment through a `dbprocessUrl` parameter URL during the registration of previous tokenized transaction. `userToken` will be used to activate the Seamless feature on the next transaction.
:::



## Sample Parameter for Tokenize - Registration API Paylater (First Payment)

:::CodeblockTabs
Request Parameter

```json
{
   "timeStamp": "20210913090977",
   "iMid": "PAYLOANTES",
   "payMethod": "06",
   "currency": "IDR",
   "amt": "25145",
   "referenceNo": "ord20210913090977",
   "goodsNm": "Test Transaction Nicepay",
   "billingNm": "Customer Name",
   "billingPhone": "12345678",
   "billingEmail": "email@merchant.com",
   "billingAddr": "Jalan Bukit Berbunga 22",
   "billingCity": "Jakarta",
   "billingState": "DKI Jakarta",
   "billingPostCd": "12345",
   "billingCountry": "Indonesia",
   "deliveryNm": "email@merchant.com",
   "deliveryPhone": "12345678",
   "deliveryAddr": "Jalan Bukit Berbunga 22",
   "deliveryCity": "Jakarta",
   "deliveryState": "DKI Jakarta",
   "deliveryPostCd": "12345",
   "deliveryCountry": "Indonesia",
   "dbProcessUrl": "http://ptsv2.com/t/nicepay-test/post",
   "merchantToken": "596129570572f2ce4f6b459a09c8c1aaf36910ed6f3feb5a6da0a7086233714a",
   "reqDomain": "merchant.com",
   "reqServerIP": "127.0.0.1",
   "userIP": "127.0.0.1",
   "userSessionID": "697D6922C961070967D3BA1BA5699C2C",
   "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/60.0.3112.101 Safari/537.36",
   "userLanguage": "ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4",
   "cartData": "{\"count\":\"1\",\"item\":[{\"goods_id\":\"BB12345678\",\"goods_detail\":\"BB12345678\",\"goods_name\":\"Pasar Modern\",\"goods_amt\":\"25145\",\"goods_type\":\"Sembako\",\"goods_url\":\"http://merchant.com/cellphones/iphone5s_64g\",\"goods_quantity\":\"1\",\"goods_sellers_id\":\"SEL123\",\"goods_sellers_name\":\"Sellers 1\"}]}",
   "sellers": "[{\"sellersId\": \"SEL123\",\"sellersNm\": \"Sellers 1\",\"sellersEmail\":\"sellers@test.com\",\"sellersAddress\": {\"sellerNm\": \"Sellers\",\"sellerLastNm\": \"1\",\"sellerAddr\": \"jalan berbangsa 1\",\"sellerCity\":\"Jakarta Barat\",\"sellerPostCd\": \"12344\",\"sellerPhone\":\"08123456789\",\"sellerCountry\": \"ID\"}}]",
   "instmntType": "2",
   "instmntMon": "1",
   "mitraCd": "KDVI",
   "tokenizeUser": "1",
   "clientUserKey": "gili.heriawan@nicepay.co.id",
   "userToken": ""
}
```

Response Parameter

```json
{
   "resultCd": "0000",
   "resultMsg": "SUCCESS",
   "tXid": "PAYLOANTES06202109130937199795",
   "referenceNo": "ord20210913090977",
   "payMethod": "06",
   "amt": "25145",
   "transDt": null,
   "transTm": null,
   "description": null,
   "bankCd": null,
   "vacctNo": null,
   "mitraCd": "KDVI",
   "payNo": null,
   "currency": null,
   "goodsNm": null,
   "billingNm": null,
   "vacctValidDt": null,
   "vacctValidTm": null,
   "payValidDt": null,
   "payValidTm": null,
   "requestURL": null,
   "paymentExpDt": null,
   "paymentExpTm": null,
   "qrContent": null,
   "qrUrl": null,
   "clientUserKey": "gili.heriawan@nicepay.co.id"
}
```
:::



# Seamless - Registration API Paylater&#x20;

***

| **API Endpoint**   | `nicepay/direct/v2/registration`                                          |
| ------------------ | ------------------------------------------------------------------------- |
| **Request Method** | <font color="#3b9f0f">**POST**</font>****                                 |
| **Description**    | Create user token                                                         |
| **Merchant Token** | **SHA256&#x20;**(`iMid` + `referenceNo` + `billingPhone` + `merchantKey`) |
| **Request Format** | `application/JSON`                                                        |



## Request Parameter for Seamless - Registration API Paylater

***

| **Parameter**     | **Type** | **Length** | **Mandatory**     | **Description**                                                                                                                               | **Example / Notes**                                              |
| ----------------- | -------- | ---------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| `timeStamp`       | N        | 14         | Mandatory         | API Request Date                                                                                                                              | 20170708123456                                                   |
| `iMid`            | AN       | 10         | Mandatory         | Merchant  ID                                                                                                                                  | PAYLOANTES                                                       |
| `payMethod`       | AN       | 2          | Mandatory         | Payment Method<br />`06`: Paylater                                                                                                            | 06                                                               |
| `currency`        | AN       | 3          | Mandatory         | Currency                                                                                                                                      | IDR                                                              |
| `amt`             | N        | 12         | Mandatory         | Payment Amount                                                                                                                                | 1000                                                             |
| `referenceNo`     | ANS      | 40         | Mandatory         | Merchant Order Number (Key from Merchant)                                                                                                     | MerchantReferenceNumber001                                       |
| `goodsNm`         | AN       | 100        | Mandatory         | Goods Name                                                                                                                                    | Merchant Goods 1                                                 |
| `billingNm`       | A        | 30         | Mandatory         | Buyer Name                                                                                                                                    | Buyer Name                                                       |
| `billingPhone`    | N        | 15         | Mandatory         | Buyer Phone Number                                                                                                                            | 02112345678                                                      |
| `billingEmail`    | AN       | 40         | Mandatory         | Buyer Email                                                                                                                                   | buyer\@merchant.com                                              |
| `billingAddr`     | AN       | 100        |                   | Buyer Address                                                                                                                                 | Billing Address                                                  |
| `billingCity`     | A        | 50         | Mandatory         | Buyer City                                                                                                                                    | Jakarta                                                          |
| `billingState`    | A        | 50         | Mandatory         | Billing State                                                                                                                                 | Jakarta                                                          |
| `billingPostCd`   | N        | 10         | Mandatory         | Billing Post Number                                                                                                                           | 12345                                                            |
| `billingCountry`  | A        | 10         | Mandatory         | Billing Country                                                                                                                               | Indonesia                                                        |
| `deliveryNm`      | A        | 30         | Mandatory         | Delivery Name                                                                                                                                 | Buyer Name                                                       |
| `deliveryPhone`   | N        | 15         | Mandatory         | Delivery Phone Number                                                                                                                         | 02112345678                                                      |
| `deliveryAddr`    | AN       | 100        | Mandatory         | Delivery Address                                                                                                                              | Billing Address                                                  |
| `deliveryCity`    | A        | 50         | Mandatory         | Delivery City                                                                                                                                 | Jakarta                                                          |
| `deliveryState`   | A        | 50         | Mandatory         | Delivery State                                                                                                                                | Jakarta                                                          |
| `deliveryPostCd`  | N        | 10         | Mandatory         | Delivery Post Number                                                                                                                          | 12345                                                            |
| `deliveryCountry` | A        | 10         | Mandatory         | Delivery Country                                                                                                                              | Indonesia                                                        |
| `dbProcessUrl`    | AN       | 255        | Mandatory         | Payment Notification URL (Async Notification)                                                                                                 | "http\://www\.merchant.com/notification”                         |
| `description`     | AN       | 100        |                   | Transaction Description                                                                                                                       | Description                                                      |
| `merchantToken`   | AN       | 255        | Mandatory         | Merchant Token                                                                                                                                | 6cfccfc0046773c1b589d8e98f8b596c284f3c70a4ecf86eba14c18944b74bcd |
| `userIP`          | AN       | 15         | Mandatory         | User IP (Customer )                                                                                                                           | 127.0.0.1                                                        |
| `userSessionID`   | AN       | 100        |                   | User Session ID                                                                                                                               | userSessionID                                                    |
| `userAgent`       | AN       | 100        |                   | User Agent Information                                                                                                                        | Mozilla                                                          |
| `userLanguage`    | A        | 2          |                   | User Language                                                                                                                                 | en-US                                                            |
| `cartData`        | AN       | 4000       | Mandatory         | Cart Data                                                                                                                                     | (JSON Format)                                                    |
| `sellers`         | AN       | 4000       | Mandatory         | Sellers                                                                                                                                       | (JSON Format)                                                    |
| `instmntType`     | N        | 2          | Mandatory         | Installment Type:<br />`1`: Customer Charge<br />`2`: Merchant Charge                                                                         | 2                                                                |
| `instmntMon`      | N        | 2          | Mandatory         | Installment Month                                                                                                                             | 1                                                                |
| `mitraCd`         | A        | 4          | Mandatory         | [Mitra Code](docId:0luP35KfOWksiSrzKx6yZ):<br />`KDVI`: Kredivo                                                                               | KDVI                                                             |
| `tokenizeUser`    | N        | 1          | Seamless Paylater | Transaction Tokenize Type:<br />`0`: Normal<br />`1`: Tokenize (First Transaction)<br />`2`: Seamless (Next Payment)                          | 2                                                                |
| `userToken`       | AN       | 50         | Seamless Paylater | User Token for using Seamless Paylater feature.<br /><br />You can get this token from `dbprocessUrl` Notification after Tokenize is success. | 59bd0cc5-0b26-42ae-be0f-caeab9424f9y                             |



## Response Parameter for Seamless - Registration API Paylater

***

| **Parameter**   | **Type** | **Length** | **Description**                                                                                                  | **Example / Notes**                                                                                                                                                                                   |
| --------------- | -------- | ---------- | ---------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `resultCd`      | N        | 4          | Result Code                                                                                                      | 0000                                                                                                                                                                                                  |
| `resultMsg`     | AN       | 255        | Result Message                                                                                                   | SUCCESS                                                                                                                                                                                               |
| `tXid`          | AN       | 30         | Transaction ID (Key from NICEPAY)                                                                                | IONPAYTEST02201607291027025291                                                                                                                                                                        |
| `referenceNo`   | ANS      | 40         | Merchant Order Number (Key from Merchant                                                                         | OrdNo20160525000-52104                                                                                                                                                                                |
| `payMethod`     | N        | 2          | [Payment Method Code](docId\:IifMsRUUw7j9VMWeFJz97)                                                              | 06                                                                                                                                                                                                    |
| `amt`           | N        | 12         | Payment Amount                                                                                                   | 1000                                                                                                                                                                                                  |
| `currency`      | AN       | 3          | Currency                                                                                                         | IDR                                                                                                                                                                                                   |
| `goodsNm`       | AN       | 100        | Goods Name                                                                                                       | Merchant Goods 1                                                                                                                                                                                      |
| `billingNm`     | A        | 30         | Buyer Name                                                                                                       | Buyer Name                                                                                                                                                                                            |
| `transDt`       | N        | 8          | Transaction Date (`YYYYMMDD`)                                                                                    | 20160303                                                                                                                                                                                              |
| `transTm`       | N        | 6          | Transaction Time (`HH24MISS`)                                                                                    | 135959                                                                                                                                                                                                |
| `description`   | AN       | 100        | Transaction Description                                                                                          | Payment of OrdNo20160525000-52104                                                                                                                                                                     |
| `bankCd`        | A        | 4          | [Bank Code](docId\:kY4pPuJOT06aTnIE_EAsF)                                                                        | BMRI                                                                                                                                                                                                  |
| `vacctNo`       | N        | 20         | Virtual Account Number                                                                                           | 123457891011                                                                                                                                                                                          |
| `vacctValidDt`  | N        | 8          | VA Expiry Date (`YYYYMMDD`)                                                                                      | 20160303                                                                                                                                                                                              |
| `vacctValidTm`  | N        | 6          | VA Expiry Time (`HH24MISS`)                                                                                      | 135959                                                                                                                                                                                                |
| `mitraCd`       | AN       | 4          | [Mitra Code](docId\:Tm257gq3DxgZf98uZ0l33)                                                                       | KDVI                                                                                                                                                                                                  |
| `payNo`         | N        | 12         | CVS Number                                                                                                       | 123456789012                                                                                                                                                                                          |
| `payValidDt`    | N        | 8          | CVS Expiry Date (`YYYYMMDD`)                                                                                     | 20170313                                                                                                                                                                                              |
| `payValidTm`    | N        | 6          | CVS Expiry Time (`HH24MISS`)                                                                                     | 135959                                                                                                                                                                                                |
| `paymentExpDt`  | N        | 6          | QR Payment Expiry Date (`YYYYMMDD`)                                                                              | 20201005                                                                                                                                                                                              |
| `paymentExpTm`  | N        | 6          | QR Payment Expiry Time (`HH24MISS`)                                                                              | 124354                                                                                                                                                                                                |
| `qrContent`     | ANS      | 360        | QR String in Plain Text                                                                                          | 00020101021226590016ID.CO.SHOPEE.WWW011893600918000041566602064156660303UME52045399530336054045.005802ID5913NICEPAY dummy6015KOTA JAKARTA SE61051287062360520082020100512385458400708T000000163044A04 |
| `qrUrl`         | ANS      | 360        | URL for QR Image, Valid for 5 Minutes.                                                                           | https\://api.wallet.airpay.co.id/v3/merchant-host/qr/download?qr=wOCiKheIXwgyjnUUk6PhJLTS1e9Ros7zf0ESj6AavQ                                                                                           |
| `clientUserKey` | AN       | 100        | User Key                                                                                                         | gili.heriawan\@nicepay.co.id                                                                                                                                                                          |
| `userToken`     | AN       | 50         | User Token for Seamless, only returned in the response body when the transaction is Seamless (tokenizeUser: `2`) | 59bd0cc5-0b26-42ae-be0f-caeab9424f95                                                                                                                                                                  |



## Sample Parameter for Seamless - Registration API Paylater

***

:::CodeblockTabs
Request Parameter

```json
{
   "timeStamp": "20210913090998",
   "iMid": "PAYLOANTES",
   "payMethod": "06",
   "currency": "IDR",
   "amt": "25145",
   "referenceNo": "ord20210913090998",
   "goodsNm": "Test Transaction Nicepay",
   "billingNm": "Customer Name",
   "billingPhone": "12345678",
   "billingEmail": "email@merchant.com",
   "billingAddr": "Jalan Bukit Berbunga 22",
   "billingCity": "Jakarta",
   "billingState": "DKI Jakarta",
   "billingPostCd": "12345",
   "billingCountry": "Indonesia",
   "deliveryNm": "email@merchant.com",
   "deliveryPhone": "12345678",
   "deliveryAddr": "Jalan Bukit Berbunga 22",
   "deliveryCity": "Jakarta",
   "deliveryState": "DKI Jakarta",
   "deliveryPostCd": "12345",
   "deliveryCountry": "Indonesia",
   "dbProcessUrl": "http://ptsv2.com/t/nicepay-test/post",
   "merchantToken": "14d2461cb1d5399c82343d0e3a8e12cdcc845625e966d0ed5fb8de6a02b3433d",
   "reqDomain": "merchant.com",
   "reqServerIP": "127.0.0.1",
   "userIP": "127.0.0.1",
   "userSessionID": "697D6922C961070967D3BA1BA5699C2C",
   "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/60.0.3112.101 Safari/537.36",
   "userLanguage": "ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4",
   "cartData": "{\"count\":\"1\",\"item\":[{\"goods_id\":\"BB12345678\",\"goods_detail\":\"BB12345678\",\"goods_name\":\"Pasar Modern\",\"goods_amt\":\"25145\",\"goods_type\":\"Sembako\",\"goods_url\":\"http://merchant.com/cellphones/iphone5s_64g\",\"goods_quantity\":\"1\",\"goods_sellers_id\":\"SEL123\",\"goods_sellers_name\":\"Sellers 1\"}]}",
   "sellers": "[{\"sellersId\": \"SEL123\",\"sellersNm\": \"Sellers 1\",\"sellersEmail\":\"sellers@test.com\",\"sellersAddress\": {\"sellerNm\": \"Sellers\",\"sellerLastNm\": \"1\",\"sellerAddr\": \"jalan berbangsa 1\",\"sellerCity\":\"Jakarta Barat\",\"sellerPostCd\": \"12344\",\"sellerPhone\":\"08123456789\",\"sellerCountry\": \"ID\"}}]",
   "instmntType": "2",
   "instmntMon": "1",
   "mitraCd": "KDVI",
   "tokenizeUser": "2",
   "clientUserKey": "",
   "userToken": "e0478456-6b50-460c-85e0-627a1e22d2e0"
}
```

Response Parameter

```json
{
   "resultCd": "0000",
   "resultMsg": "SUCCESS",
   "tXid": "PAYLOANTES06202109130955379813",
   "referenceNo": "ord20210913090998",
   "payMethod": "06",
   "amt": "25145",
   "transDt": null,
   "transTm": null,
   "description": null,
   "bankCd": null,
   "vacctNo": null,
   "mitraCd": "KDVI",
   "payNo": null,
   "currency": null,
   "goodsNm": null,
   "billingNm": null,
   "vacctValidDt": null,
   "vacctValidTm": null,
   "payValidDt": null,
   "payValidTm": null,
   "requestURL": null,
   "paymentExpDt": null,
   "paymentExpTm": null,
   "qrContent": null,
   "qrUrl": null,
   "userToken": "e0478456-6b50-460c-85e0-627a1e22d2e0"
}
```
:::

