---
title: Seamless - Registration API Paylater
slug: 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/EXMdrFABs9T2K2qPD35FY_nicepay-docs-logo.png
icon: {"faIcon":"fa-solid fa-book"}
docTags: 
createdAt: 2025-10-07T03:36:49.283Z
---

# Tentang Seamless - Registration API Paylater

***

Transaksi tipe Seamless adalah layanan Paylater milik NICEPAY yang memberikan pengalaman pembayaran nanti atau cicilan lebih cepat dan efisien. Melalui layanan ini, pengguna dapat menghubungkan akun mereka dengan Merchant tanpa perlu melakukan autentikasi transaksi seperti login akun terlebih dahulu saat pembayaran. Sehingga, setiap proses transaksi antara Pelanggan dan Merchant dapat berjalan lebih efisien tanpa pengulangan tahap autentikasi login akun pengguna dengan keamanan yang tetap terjaga dan dapat diandalkan oleh NICEPAY.

:::hint{type="info"}
Saat ini, hanya Kredivo yang sudah mendukung fitur Seamless.
:::

Terdapat dua cara untuk mengaktifkan transaksi dengan tipe Seamless, yaitu:

1. Melakukan tokenize data Pelanggan dengan membuat transaksi terlebih dahulu.
2. Menggunakan fitur [Registration & Notification - Account Binding Paylater API](docId\:HU_q-9UZjxF32uv9gLBGK).

Halaman ini menjelaskan lebih mendalam mengenai proses tokenize data Pelanggan melalui transaksi pertama, sehingga fitur Seamless dapat digunakan untuk transaksi berikutnya.



# Alur Proses

***

## 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")

Deskripsi alur:

1. Pelanggan melakukan *checkout*.
2. Pelanggan mengajukan *checkout&#x20;*&#x6B;epada Merchant.
3. Merchant mengajukan *checkout&#x20;*&#x6B;epada NICEPAY.
4. NICEPAY mengajukan *checkout&#x20;*&#x6B;epada Paylater Partner.&#x20;
5. Paylater Partner mendaftarkan *checkout*.
6. Paylater Partner mengirimkan *response&#x20;*&#x6B;epada NICEPAY.
7. NICEPAY mengirimkan *redirect&#x20;*&#x55;RL kepada Merchant.
8. Merchant mengarahkan Pelanggan menuju halaman Partner.
9. Pelanggan melakukan login pada Halaman Login Partner.
10. Pelanggan mengirimkan kredensial kepada Paylater Partner.
11. Paylater Partner melakukan validasi login.
12. Paylater Partner mengirimkan laporan Settlement kepada Pelanggan.
13. Pelanggan melihat laporan Settlement.
14. Pelanggan membayar dan mengonfirmasi Settlement kepada Paylater Partner .
15. Paylater Partner melakukan validasi pembayaran.
16. Pada saat proses transaksi berlangsung:
    - Jika transaksi disetujui, maka:
      - Paylater Partner memproses persetujuan.
      - Paylater Partner mengirimkan hasil persetujuan kepada NICEPAY.
      - NICEPAY menerima hasil persetujuan.
      - NICEPAY mengirimkan hasil persetujuan kepada Merchant.
      - Merchant menerima notifikasi hasil persetujuan.
      - Merchant melakukan pengajuan status kepada NICEPAY.
      - NICEPAY melakukan pengecekan status.
      - NICEPAY mengirimkan hasil status kepada Merchant.
      - Merchant menerima status akhir.
      - Merchant mengirimkan status notifikasi kepada Pelanggan.
      - Pelanggan menerima hasil persetujuan.
    - Jika transaksi masih diperiksa, maka:
      - Paylater Partner mengarahkan Pelanggan menuju halaman Merchant/NICEPAY.
      - Pelanggan ditampilkan halaman Merchant/NICEPAY.
      - Pelanggan menunggu persetujuan.



### 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")

Deskripsi alur:

1. Pelanggan mendaftarkan nomor telepon kepada Merchant.
2. Merchant mengajukan penghubungan akun kepada NICEPAY.
3. NICEPAY mengajukan penghubungan akun kepada Paylater Partner.
4. Paylater Partner melakukan validasi.
5. Paylater Partner mengirimkan *response&#x20;*&#x6B;epada NICEPAY.
6. NICEPAY melakukan *return redirect* URL terhadap Merchant.
7. Merchant mengarahkan Pelanggan menuju halaman Partner.
8. Pelanggan melakukan login melalui Halaman Login Partner.
9. Pelanggan mengirimkan kredensial kepada Paylater Partner.
10. Paylater Partner melakukan validasi login.
11. Paylater Partner melakukan *return&#x20;*&#x4F;TP terhadap Pelanggan.
12. Pelanggan memasukkan OTP kepada Paylater Partner .
13. Paylater Partner melakukan *generate&#x20;*&#x55;ser Token.
14. Paylater Partner mengarahkan Pelanggan menuju halaman Merchant/NICEPAY.
15. Pada saat proses pengajuan penghubungan akun:
    - Pada bagian Pelanggan :
      - Halaman NICEPAY/Merchant ditampilkan pada Pelanggan.
      - Pelanggan menunggu persetujuan.
    - Dari bagian Notifikasi:
      - Paylater Partner mengirimkan notifikasi kepada NICEPAY.
      - NICEPAYmenerima notifikasi.
      - NICEPAY mengirimkan notifikasi kepada Merchant.
      - Merchant menerima notifikasi.
      - Merchant menampilkan hasil penghubungan akun kepada Pelanggan.



## Deactivate Tokenize

:::hint{type="info"}
Silakan kunjungi halaman [Deactivate - Account Binding Paylater API](docId\:zZvRQbO6U_qUaiV2A0tMj) untuk informasi lebih lanjut terkait proses menonaktifkan user token pada fitur Seamless.
:::



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**                                                                         | **Tipe**           | **Ukuran** | **Deskripsi**                                                                                                                 | **Contoh / Catatan**                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                              |
| ------------------------------------------------------------------------------------- | ------------------ | ---------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- |
| `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\:g7inRV70XcSA9lP7bpmok) <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\:DwzaQDD7DXZMECz80A6o8)                                                                                    | KDVI                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                              |
| `instmntType`<br /><font color="#2166ae">Required</font>                              | N                  | 8          | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO)                                                                          | 2                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |                              |
| `instmntMon`<br /><font color="#2166ae">Required</font>                               | N                  | 6          | `1`: 1 Month/Full Payment, *jika* *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\:gvAdBBr0SQ92N1zHplSFM)                 | 0000                                                                                                                                                                                                  |
| `resultMsg`     | AN       | 255        | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD)  | 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\:g7inRV70XcSA9lP7bpmok)         | 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:1U7QOax_wrzXMoCG-Mqad)                    | 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\:DwzaQDD7DXZMECz80A6o8)                  | 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"}
Setelah Pelanggan berhasil melakukan pembayaran transaksi dengan tokenize, Merchant akan mendapatkan parameter `userToken` dari [Notification - API Paylater](docId\:tLx6S6yonkvOMuyhJMQ8Z) terkait pembayaran sukses melalui URL parameter `dbprocessUrl` pada saat registrasi transaksi tokenize sebelumnya.

`userToken` tersebut akan digunakan untuk mengaktifkan fitur Seamless pada transaksi berikutnya.
:::



## 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**     | **Tipe** | **Ukuran** | **Kebutuhan**     | **Deskripsi**                                                                                                                                 | **Contoh / Catatan**                                             |
| ----------------- | -------- | ---------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| `timeStamp`       | N        | 14         | Mandatory         | API Request Date                                                                                                                              | 20170708123456                                                   |
| `iMid`            | AN       | 10         | Mandatory         | Merchant  ID                                                                                                                                  | PAYLOANTES                                                       |
| `payMethod`       | AN       | 2          | Mandatory         | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) <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                                                                                                               | 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\:DwzaQDD7DXZMECz80A6o8):<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-caeab9424f95<br />                       |



## Response Parameter for Seamless - Registration API Paylater

***

| **Parameter**   | **Tipe** | **Ukuran** | **Deskripsi**                                                                                                    | **Contoh / Catatan**                                                                                                                                                                                  |
| --------------- | -------- | ---------- | ---------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `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\:g7inRV70XcSA9lP7bpmok)                                                              | 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:1U7QOax_wrzXMoCG-Mqad)                                                                         | 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\:DwzaQDD7DXZMECz80A6o8)                                                                       | 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 - Payment 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"
}
```
:::

