Registration - API Checkout

17 min

Tentang Registration - API Checkout
﻿
Langkah pada Registration - API Checkout ini berfungsi untuk mendaftarkan sebuah request checkout belanja dari ﻿ ﻿ kepada kami. Sehingga ﻿ ﻿ dapat membayar jumlah ﻿ yang ditagihkan pada payment page ﻿ ﻿ sediakan.
Pada prinsipnya, semua ﻿ pada ﻿ ﻿ memiliki ﻿ ﻿ sama. Hanya saja ﻿ membedakan adalah ﻿ pada setiap ﻿. 
Pada saat ﻿ melakukan ﻿ ﻿, ﻿ melakukan ﻿ pendaftaran pesanan sebelum ﻿ dapat melakukan ﻿ ﻿ pada ﻿ ﻿ diinginkan melalui tautan ﻿ ﻿ didapatkan.
﻿
﻿﻿ kunjungi ﻿ Payment - API Checkout﻿ untuk mengetahui penjelasan lebih rinci terkait ﻿ khusus ﻿.
﻿
Registration - API Checkout (All Payment Method)
﻿
Untuk dapat menggunakan seluruh ﻿ pada ﻿ ﻿ kecuali ﻿, ﻿ diperlukan untuk mendaftarkan ﻿ tersebut dengan ﻿ Registrasi ﻿ ini. Berikut ﻿nya:
API URL
/nicepay/redirect/v2/registration
Method
﻿POST﻿
Header
Content-Type: application/json
Merchant Token
SHA256 (timestamp+ iMid+ referenceNo+ amt+ merchantKey)
﻿
Request Parameter for API Checkout Registration
﻿
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
iMid
﻿Required﻿
AN
10
﻿﻿ ID
IONPAYTEST
timeStamp
﻿Required﻿
N
14
Request Timestamp
(YYYYMMDDHH24MISS)
20230516660517
payMethod
﻿Required﻿
N
2
﻿Payment Method Code﻿﻿
00
bankCd
A
4
﻿Bank Code﻿﻿
CENA
currency
﻿Required﻿
AN
3
Currency
IDR
amt
﻿Required﻿
N
12
Transaction Amount
10000
referenceNo
﻿Required﻿
ANS
40
﻿﻿ Order Number
MerchantReferenceNumber001
merchantToken
﻿Required﻿
AN
255
﻿﻿ Token
4686062c297a3e48cf385953f411bbd48753bb70b041f2113a3e7c2e99c54f3c
callBackUrl
﻿Required﻿
AN
255
﻿﻿ Result Forward URL
https://www.merchant.com/callbackUrl/
dbProcessUrl
﻿Required﻿
AN
255
﻿﻿ Notification URL
https://www.merchant.com/dbProcessUrl
goodsNm
﻿Required﻿
AN
100
Goods Name
﻿﻿ Goods 1
mitraCd
﻿Required For CVS, E-Wallet & ﻿Payloan﻿
AN
4
﻿Mitra Code﻿﻿
DANA
vacctValidDt
Required For VA﻿
N
8
VA Expiry Date
(YYYYMMDD)
20230531
vacctValidTm
﻿Required For VA﻿
N
8
VA Expiry Time
(HH24MISS)
235959
description
﻿Required﻿
AN
100
Transaction Description
This Is The Description Of The ﻿ 
billingNm
﻿Required﻿
A
100
Billing Name
John Doe
billingPhone
﻿Required﻿
N
15
Billing Phone
08123456789
billingEmail
﻿Required﻿
AN
40
Billing E-mail
john.doe@example.com
billingAddr
AN
100
Billing Address
Jln. Raya Casablanka Kav.88
billingCity
﻿Required﻿
A
50
Billing City
South Jakarta
billingState
﻿Required﻿
A
50
Billing State
DKI Jakarta
billingPostCd
﻿Required﻿
N
10
Billing Post Number
10200
billingCountry
﻿Required﻿
A
10
Billing Country
﻿﻿ 
userIP
AN
15
User IP
127.0.0.1
cartData
﻿Required﻿
AN
4000
Cart Data
{\"count\":\"1\",\"item\":[{\"goods_id\":\"BB12345678\",\"goods_detail\":\"BB123456\",\"goods_name\":\"iPhone5S\",\"goods_amt\":\"10000\",\"goods_type\":\"Smartphone\",\"goods_url\":\"http://merchant.com/cellphones/iphone5s_64g\",\"goods_quantity\":\"1\",\"goods_sellers_id\":\"SEL123\",\"goods_sellers_name\":\"Sellers1\"}]}
deliveryNm
A
30
Delivery Name
﻿﻿'s Name
deliveryPhone
N
15
Delivery Phone
08123456789
deliveryAddr
AN
100
Delivery Address
Jln. Dr.Saharjo No.88
deliveryCity
A
50
Delivery City
South Jakarta
deliveryState
A
50
Delivery State
DKI Jakarta
deliveryPostCd
N
10
Delivery Post Number
10201
deliveryCountry
A
10
Delivery Country
﻿﻿ 
vat
N
12
Value Added Tax (﻿)
﻿
fee
N
12
Service Fee
﻿
notaxAmt
N
12
Tax Free Amount
﻿
reqDt
N 
8
Request Date
(YYYYMMDD)
﻿
reqTm
N
6
Request Time
(HH24MISS)
﻿
reqDomain
AN
100
Request Domain
merchant.com
reqServerIP
AN
15
Request Server IP
127.0.0.1
reqClientVer
AN
50
Request Client Version
﻿
userSessionID
AN
100
User Session ID
﻿
userAgent
AN
100
User Agent Information
﻿
userLanguage
A
2
User Language
﻿
sellers
﻿Required For Payloan﻿
JSON String
4000
Seller Data
[{"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
﻿Required For CC & Payloan 
N
2
﻿Installment Type Code﻿ 
1 (For Pre-Auth & Recurring default 1)
instmntMon
﻿Required For CC & Payloan ﻿
N
2
Installment Month 
1: 1 Month/Full ﻿, ifinstmntType: null/1
1 (For Pre-Auth & Recurring default 1)
recurrOpt
﻿Required For CC﻿
N
2
0: Automatic Cancel
1: Do not cancel
2: Do not make token
2
merFixAcctId
﻿Required For VA (Fixed Type)﻿
AN
40
﻿﻿ Reserved VA ID
﻿
(Maks. 8 Digit Angka)
payValidDt
﻿Required For CVS﻿
N
8
CVS Expiry Date (YYYYMMDD)
20221212
payValidTm
﻿Required For CVS﻿
N
6
CVS Expiry Time (HH24MISS)
201012
paymentExpDt
﻿Required For QRIS﻿
N
8
QR ﻿ Expiry Date (YYYYMMDD)	
20221208
paymentExpTm
﻿Required For QRIS﻿
N
6
QR ﻿ Expiry Time (HH24MISS)
092330
shopId
﻿Required For QRIS﻿
AN
25
Shop ID
216660000000833315280
﻿
Response Parameters for API Checkout Registration
﻿
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
resultCd
N
4
﻿Result Code﻿﻿
0000
resultMsg
AN
255
﻿Result Message﻿ 
SUCCESS
tXid
AN
30
Transaction ID
IONPAYTEST00202305161555223616
﻿
When Success
referenceNo
ANS
40
﻿﻿ Order Number
﻿﻿ReferenceNumber001
payMethod
N
2
﻿Payment Method Code﻿ 
﻿
00
﻿
When Success
amt
N
12
Amount
10000
﻿
When Success
transDt
N
8
Transaction Date
(YYYYMMDD)
20230516
﻿
When Success
transTm
N
6
Transaction Time
(HH24MISS)
135959
﻿
When Success
description
AN
100
Transaction Description
This Is The Description Of The ﻿ 
﻿
When Success
currency
AN
3
Currency
IDR
﻿
When Success
goodsNm
AN
100
Goods Name
﻿﻿ Goods 1
﻿
When Success
billingNm
A
100
Buyer Name
John Doe
﻿
When Success
payValidDt
N
8
CVS Expiry Date
(YYYYMMDD)
null
payValidTm
N
6
CVS Expiry Time
(HH24MISS)
null
paymentURL
AN
40
Redirect URL ﻿ 
https://www.nicepay.co.id/nicepay/redirect/v2/payment
Setelah ﻿ ﻿ sudah didaftarkan, arahkan ﻿ ﻿ langsung menuju ﻿ ﻿ kami untuk melakukan ﻿ ﻿. ﻿ periksa ﻿ Payment - API Checkout﻿ untuk mengetahui penjelasan lebih rinci.
﻿
Sample JSON API Checkout Registration
﻿
JSON Request
JSON Response
Java Request
{
	"timeStamp":"20250211090266",
	"iMid":"IONPAYTEST",
	"payMethod":"00",
	"currency":"IDR",
	"amt":"10000",
	"referenceNo":"ORD20250211090266",
	"goodsNm":"Jhon Doe",
	"billingNm":"Jhon Doe",
	"billingPhone":"08123456789",
	"billingEmail":"jhondoe@gmail.com",
	"billingAddr":"Jalan Bukit Berbunga 22",
	"billingCity":"Jakarta",
	"billingState":"DKI Jakarta",
	"billingPostCd":"12345",
	"billingCountry":"Indonesia",
	"deliveryNm":"jhondoe@gmail.com",
	"deliveryPhone":"08123456789",
	"deliveryAddr":"Jalan Bukit Berbunga 22",
	"deliveryCity":"Jakarta",
	"deliveryState":"DKI Jakarta",
	"deliveryPostCd":"12345",
	"deliveryCountry":"Indonesia",
	"dbProcessUrl":"http://ptsv2.com/t/Merchant/post",
    "callBackUrl":"https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp",
	"vat":"",
	"fee":"",
	"notaxAmt":"",
	"description":"Test Transaction Nicepay",
	"merchantToken":"d339576df6d69763073b626fc88b0bbe9e0f9023d376d37372e1af96dde7d059",
	"reqDt":"",
	"reqTm":"",
	"reqDomain":"merchant.com",
	"reqServerIP":"127.0.0.1",
	"reqClientVer":"",
	"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\":\"10000\",\"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",
	"recurrOpt":"1",
	"bankCd":"",
    "vacctValidDt":"",
    "vacctValidTm":"",
    "payValidDt":"",
    "payValidTm":"",
	"merFixAcctId":"", 
	"mitraCd":"",
	"paymentExpDt":"",
    "paymentExpTm":"",
	"shopId":""
}
{
	"timeStamp":"20250211090266",
	"iMid":"IONPAYTEST",
	"payMethod":"00",
	"currency":"IDR",
	"amt":"10000",
	"referenceNo":"ORD20250211090266",
	"goodsNm":"Jhon Doe",
	"billingNm":"Jhon Doe",
	"billingPhone":"08123456789",
	"billingEmail":"jhondoe@gmail.com",
	"billingAddr":"Jalan Bukit Berbunga 22",
	"billingCity":"Jakarta",
	"billingState":"DKI Jakarta",
	"billingPostCd":"12345",
	"billingCountry":"Indonesia",
	"deliveryNm":"jhondoe@gmail.com",
	"deliveryPhone":"08123456789",
	"deliveryAddr":"Jalan Bukit Berbunga 22",
	"deliveryCity":"Jakarta",
	"deliveryState":"DKI Jakarta",
	"deliveryPostCd":"12345",
	"deliveryCountry":"Indonesia",
	"dbProcessUrl":"http://ptsv2.com/t/Merchant/post",
    "callBackUrl":"https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp",
	"vat":"",
	"fee":"",
	"notaxAmt":"",
	"description":"Test Transaction Nicepay",
	"merchantToken":"d339576df6d69763073b626fc88b0bbe9e0f9023d376d37372e1af96dde7d059",
	"reqDt":"",
	"reqTm":"",
	"reqDomain":"merchant.com",
	"reqServerIP":"127.0.0.1",
	"reqClientVer":"",
	"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\":\"10000\",\"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",
	"recurrOpt":"1",
	"bankCd":"",
    "vacctValidDt":"",
    "vacctValidTm":"",
    "payValidDt":"",
    "payValidTm":"",
	"merFixAcctId":"", 
	"mitraCd":"",
	"paymentExpDt":"",
    "paymentExpTm":"",
	"shopId":""
}
﻿
﻿
Cart Data, Payloan Cart Data, dan Payloan Seller Data Chekout API
﻿
Cart Data pada ﻿ ﻿ berguna untuk mendeklarasikan item apa saja ﻿ akan di-checkout beserta rincian dan harga per item. Cart Data ini berlaku untuk semua ﻿, kecuali ﻿ menggunakan ﻿ dikarenakan ﻿ ﻿ memiliki Cart Data khusus.
﻿
Cart Data
﻿
cartData harus dilepas dalam bentuk string. 
Karakter spesial tidak didukung dalam cartData. 
Pastikan bahwa count sama dengan jumlah object item. 
Pastikan bahwa goods_amt x goods_quantity sama dengan ﻿ amt.
Parameter
Deskripsi
Contoh
Count
Total jumlah dari keseluruhan cart data
2
Item
Terbagi menjadi 5 macam ﻿, yaitu img_url, goods_name, goods_detail, goods_amt, dan goods_quantity
-
Penjelasan detail pada parameter Item.
Parameter
Deskripsi
Contoh
img_url
URL Gambar Barang (Ukuran 50px x 50px)
http://img.aaa.com/ima1.jpg
goods_name
Nama Barang
Item 1 Name
goods_detail
Deskripsi Detail Barang
Item 1 Detail
goods_amt
Harga Barang
700
goods_quantity
Jumlah Barang
1
Card Data
{
    "count": "2",  
    "item": [  
        {
            "img_url": "http://img.aaa.com/ima1.jpg",  
            "goods_name": "Item 1 Name",
            "goods_detail": "Item 1 Detail",
            "goods_amt": "700",
            "goods_quantity": "1"
        },  
        {
            "img_url": "http://img.aaa.com/ima2.jpg",
            "goods_name": "Item 2 Name",
            "goods_detail": "Item 2 Detail",
            "goods_amt": "300",
            "goods_quantity": "1"
        }  
        ] 
} 
{
    "count": "2",  
    "item": [  
        {
            "img_url": "http://img.aaa.com/ima1.jpg",  
            "goods_name": "Item 1 Name",
            "goods_detail": "Item 1 Detail",
            "goods_amt": "700",
            "goods_quantity": "1"
        },  
        {
            "img_url": "http://img.aaa.com/ima2.jpg",
            "goods_name": "Item 2 Name",
            "goods_detail": "Item 2 Detail",
            "goods_amt": "300",
            "goods_quantity": "1"
        }  
        ] 
} 
﻿
﻿
Payloan Cart Data
﻿
Parameter
Deskripsi
count
Total Cart Data Count
item
List of Goods
item -> goods_id
Goods ID
item -> goods_detail
Goods Detail
item -> goods_name
Goods Name
item -> goods_amt
Goods Amount
item -> goods_type
Goods Type
item -> goods_url
Goods URL
item -> goods_quantity
Goods Quantity
item -> goods_sellers_id
Seller's ID
item -> goods_sellers_name
Seller's Name
cartData wajib dilepas dalam format string.
JSON
{
  "count": "2",
  "item": [
    {
      "goods_id": "BB12345678",
      "goods_detail": "BB123456",
      "goods_name": "iPhone 5S",
      "goods_amt": "6000000",
      "goods_type": "Smartphone",
      "goods_url": "http://merchant.com/cel lphones/iphone5s_64g",
      "goods_quantity": "1",
      "goods_sellers_id": "SEL123",
      "goods_sellers_name": "Sellers 1"
    },
    {
      "goods_id": "AZ14565678",
      "goods_name": "Hailee Sneakers Blink Silver",
      "goods_amt": "250000",
      "goods_url": "http://merchant.com/fashion/shoes/sneakers-blinkshoes",
      "goods_type": "Sneakers",
      "goods_quantity": "2",
      "goods_sellers_id": "SEL124",
      "goods_ sellers_name": "Sellers 2"
    }
  ]
}
{
  "count": "2",
  "item": [
    {
      "goods_id": "BB12345678",
      "goods_detail": "BB123456",
      "goods_name": "iPhone 5S",
      "goods_amt": "6000000",
      "goods_type": "Smartphone",
      "goods_url": "http://merchant.com/cel lphones/iphone5s_64g",
      "goods_quantity": "1",
      "goods_sellers_id": "SEL123",
      "goods_sellers_name": "Sellers 1"
    },
    {
      "goods_id": "AZ14565678",
      "goods_name": "Hailee Sneakers Blink Silver",
      "goods_amt": "250000",
      "goods_url": "http://merchant.com/fashion/shoes/sneakers-blinkshoes",
      "goods_type": "Sneakers",
      "goods_quantity": "2",
      "goods_sellers_id": "SEL124",
      "goods_ sellers_name": "Sellers 2"
    }
  ]
}
﻿
cartData secara spesifik untuk ﻿. 
Pastikan ﻿-﻿ countberdasarkan dengan nomor tipe barang-barang. 
Pastikan goods_sellers_id dan goods_sellers_name berisi sesuai dengan sellers pada Registration.
﻿
Payloan Sellers Data
﻿
Parameter
Deskripsi
sellersId
Seller's ID
sellersNm
Seller's Name
sellersEmail
Seller's E-mail
sellersUrl
Seller's URL
sellersAddress -> sellerNm
Seller's Name
sellersAddress -> sellerLastNm
Seller's Last Name
sellersAddress -> sellerAddr
Seller's Address
sellersAddress -> sellerCity
Seller's City
sellersAddress -> sellerPostCd
Seller's Postal Code
sellersAddress -> sellerPhone
Seller's Phone
sellersAddress -> sellerCountry
Seller's Country
JSON
[
  {
    "sellersId": "SEL123",
    "sellersNm": "Sellers 1",
    "sellersEmail": "sellers@test.com",
    "sellersUrl": "http://nicestore.store",
    "sellersAddress": {
      "sellerNm": "Sellers",
      "sellerLastNm": "1",
      "sellerAddr": "jalan berbangsa 1",
      "sellerCity": "Jakarta Barat",
      "sellerPostCd": "12344",
      "sellerPhone": "08123456789",
      "sellerCountry": "ID"
    }
  },
  {
    "sellersId": "SEL124",
    "sellersNm": "Sellers 2",
    "sellersEmail": "sellers2@test.com",
    "sellersUrl": "http://nicestore.store",
    "sellersAddress": {
      "sellerNm": "Sellers",
      "sellerLastNm": "2",
      "sellerAddr": "jalan berkelok 3",
      "sellerCity": "Jakarta Utara",
      "sellerPostCd": "12222",
      "sellerPhone": "081255556789",
      "sellerCountry": "ID"
    }
  }
]
[
  {
    "sellersId": "SEL123",
    "sellersNm": "Sellers 1",
    "sellersEmail": "sellers@test.com",
    "sellersUrl": "http://nicestore.store",
    "sellersAddress": {
      "sellerNm": "Sellers",
      "sellerLastNm": "1",
      "sellerAddr": "jalan berbangsa 1",
      "sellerCity": "Jakarta Barat",
      "sellerPostCd": "12344",
      "sellerPhone": "08123456789",
      "sellerCountry": "ID"
    }
  },
  {
    "sellersId": "SEL124",
    "sellersNm": "Sellers 2",
    "sellersEmail": "sellers2@test.com",
    "sellersUrl": "http://nicestore.store",
    "sellersAddress": {
      "sellerNm": "Sellers",
      "sellerLastNm": "2",
      "sellerAddr": "jalan berkelok 3",
      "sellerCity": "Jakarta Utara",
      "sellerPostCd": "12222",
      "sellerPhone": "081255556789",
      "sellerCountry": "ID"
    }
  }
]
﻿
﻿

API URL	/nicepay/redirect/v2/registration
Method	POST
Header	Content-Type: application/json
Merchant Token	SHA256 (timestamp+ iMid+ referenceNo+ amt+ merchantKey)

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
iMid Required	AN	10	ID	IONPAYTEST
timeStamp Required	N	14	Request Timestamp (YYYYMMDDHH24MISS)	20230516660517
payMethod Required	N	2	Payment Method Code	00
bankCd	A	4	Bank Code	CENA
currency Required	AN	3	Currency	IDR
amt Required	N	12	Transaction Amount	10000
referenceNo Required	ANS	40	Order Number	MerchantReferenceNumber001
merchantToken Required	AN	255	Token	4686062c297a3e48cf385953f411bbd48753bb70b041f2113a3e7c2e99c54f3c
callBackUrl Required	AN	255	Result Forward URL	https://www.merchant.com/callbackUrl/
dbProcessUrl Required	AN	255	Notification URL	https://www.merchant.com/dbProcessUrl
goodsNm Required	AN	100	Goods Name	Goods 1
mitraCd Required For CVS, E-Wallet & Payloan	AN	4	Mitra Code	DANA
vacctValidDt Required For VA	N	8	VA Expiry Date (YYYYMMDD)	20230531
vacctValidTm Required For VA	N	8	VA Expiry Time (HH24MISS)	235959
description Required	AN	100	Transaction Description	This Is The Description Of The
billingNm Required	A	100	Billing Name	John Doe
billingPhone Required	N	15	Billing Phone	08123456789
billingEmail Required	AN	40	Billing E-mail	john.doe@example.com
billingAddr	AN	100	Billing Address	Jln. Raya Casablanka Kav.88
billingCity Required	A	50	Billing City	South Jakarta
billingState Required	A	50	Billing State	DKI Jakarta
billingPostCd Required	N	10	Billing Post Number	10200
billingCountry Required	A	10	Billing Country
userIP	AN	15	User IP	127.0.0.1
cartData Required	AN	4000	Cart Data	{\"count\":\"1\",\"item\":[{\"goods_id\":\"BB12345678\",\"goods_detail\":\"BB123456\",\"goods_name\":\"iPhone5S\",\"goods_amt\":\"10000\",\"goods_type\":\"Smartphone\",\"goods_url\":\"http://merchant.com/cellphones/iphone5s_64g\",\"goods_quantity\":\"1\",\"goods_sellers_id\":\"SEL123\",\"goods_sellers_name\":\"Sellers1\"}]}
deliveryNm	A	30	Delivery Name	's Name
deliveryPhone	N	15	Delivery Phone	08123456789
deliveryAddr	AN	100	Delivery Address	Jln. Dr.Saharjo No.88
deliveryCity	A	50	Delivery City	South Jakarta
deliveryState	A	50	Delivery State	DKI Jakarta
deliveryPostCd	N	10	Delivery Post Number	10201
deliveryCountry	A	10	Delivery Country
vat	N	12	Value Added Tax ()
fee	N	12	Service Fee
notaxAmt	N	12	Tax Free Amount
reqDt	N	8	Request Date (YYYYMMDD)
reqTm	N	6	Request Time (HH24MISS)
reqDomain	AN	100	Request Domain	merchant.com
reqServerIP	AN	15	Request Server IP	127.0.0.1
reqClientVer	AN	50	Request Client Version
userSessionID	AN	100	User Session ID
userAgent	AN	100	User Agent Information
userLanguage	A	2	User Language
sellers Required For Payloan	JSON String	4000	Seller Data	[{"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 Required For CC & Payloan	N	2	Installment Type Code	1 (For Pre-Auth & Recurring default 1)
instmntMon Required For CC & Payloan	N	2	Installment Month 1: 1 Month/Full , ifinstmntType: null/1	1 (For Pre-Auth & Recurring default 1)
recurrOpt Required For CC	N	2	0: Automatic Cancel 1: Do not cancel 2: Do not make token	2
merFixAcctId Required For VA (Fixed Type)	AN	40	Reserved VA ID	(Maks. 8 Digit Angka)
payValidDt Required For CVS	N	8	CVS Expiry Date (YYYYMMDD)	20221212
payValidTm Required For CVS	N	6	CVS Expiry Time (HH24MISS)	201012
paymentExpDt Required For QRIS	N	8	QR Expiry Date (YYYYMMDD)	20221208
paymentExpTm Required For QRIS	N	6	QR Expiry Time (HH24MISS)	092330
shopId Required For QRIS	AN	25	Shop ID	216660000000833315280

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
resultCd	N	4	Result Code	0000
resultMsg	AN	255	Result Message	SUCCESS
tXid	AN	30	Transaction ID	IONPAYTEST00202305161555223616 When Success
referenceNo	ANS	40	Order Number	ReferenceNumber001
payMethod	N	2	Payment Method Code	00 When Success
amt	N	12	Amount	10000 When Success
transDt	N	8	Transaction Date (YYYYMMDD)	20230516 When Success
transTm	N	6	Transaction Time (HH24MISS)	135959 When Success
description	AN	100	Transaction Description	This Is The Description Of The When Success
currency	AN	3	Currency	IDR When Success
goodsNm	AN	100	Goods Name	Goods 1 When Success
billingNm	A	100	Buyer Name	John Doe When Success
payValidDt	N	8	CVS Expiry Date (YYYYMMDD)	null
payValidTm	N	6	CVS Expiry Time (HH24MISS)	null
paymentURL	AN	40	Redirect URL	https://www.nicepay.co.id/nicepay/redirect/v2/payment

Parameter	Deskripsi	Contoh
Count	Total jumlah dari keseluruhan cart data	2
Item	Terbagi menjadi 5 macam , yaitu img_url, goods_name, goods_detail, goods_amt, dan goods_quantity	-

Parameter	Deskripsi	Contoh
img_url	URL Gambar Barang (Ukuran 50px x 50px)	http://img.aaa.com/ima1.jpg
goods_name	Nama Barang	Item 1 Name
goods_detail	Deskripsi Detail Barang	Item 1 Detail
goods_amt	Harga Barang	700
goods_quantity	Jumlah Barang	1

Parameter	Deskripsi
count	Total Cart Data Count
item	List of Goods
item -> goods_id	Goods ID
item -> goods_detail	Goods Detail
item -> goods_name	Goods Name
item -> goods_amt	Goods Amount
item -> goods_type	Goods Type
item -> goods_url	Goods URL
item -> goods_quantity	Goods Quantity
item -> goods_sellers_id	Seller's ID
item -> goods_sellers_name	Seller's Name

Parameter	Deskripsi
sellersId	Seller's ID
sellersNm	Seller's Name
sellersEmail	Seller's E-mail
sellersUrl	Seller's URL
sellersAddress -> sellerNm	Seller's Name
sellersAddress -> sellerLastNm	Seller's Last Name
sellersAddress -> sellerAddr	Seller's Address
sellersAddress -> sellerCity	Seller's City
sellersAddress -> sellerPostCd	Seller's Postal Code
sellersAddress -> sellerPhone	Seller's Phone
sellersAddress -> sellerCountry	Seller's Country

Checkout API

Payment - API Checkout

Registration - API Checkout

Tentang Registration - API Checkout

Registration - API Checkout (All Payment Method)

Request Parameter for API Checkout Registration

Response Parameters for API Checkout Registration

Sample JSON API Checkout Registration

Cart Data, Payloan Cart Data, dan Payloan Seller Data Chekout API

Cart Data

Payloan Cart Data

Payloan Sellers Data

Selamat Datang di NICEPAY DOCS