NICEPAY API
...
API Versi 2
Checkout API

Registration - API Checkout

18min

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 .

Berikut ini adalah dapat dipilih oleh untuk melakukan , yakni:

 melanjutkan membaca ini untuk mengetahui rincian Registration lebih lanjut.



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

00

bankCd

A

4

Bank Code

CENA

currency

Required

AN

3

Currency

IDR

amt

N

12

Transaction Amount

10000

referenceNo

Required

ANS

40

 Order Number

MerchantReferenceNumber001

merchantToken

Required

AN

255

 Token

4686062c297a3e48cf385953f411bbd48753bb70b041f2113a3e7c2e99c54f3c

callBackUrl

AN

255

 Result Forward URL

https://www.merchant.com/callbackUrl/

dbProcessUrl

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

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 ()

(empty)

fee

N

12

Service Fee

(empty)

notaxAmt

N

12

Tax Free Amount

(empty)

reqDt

N

8

Request Date

(YYYYMMDD)

(empty)

reqTm

N

6

Request Time

(HH24MISS)

(empty)

reqDomain

AN

100

Request Domain

(empty)

reqServerIP

AN

15

Request Server IP

(empty)

reqClientVer

AN

50

Request Client Version

(empty)

userSessionID

AN

100

User Session ID

(empty)

userAgent

AN

100

User Agent Information

(empty)

userLanguage

A

2

User Language

(empty)



Response Parameters for API Checkout Registration



Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

resultCd

N

4

Result Code

0000

resultMsg

AN

255

SUCCESS

tXid

AN

30

Transaction ID

IONPAYTEST00202305161555223616



When Success

referenceNo

ANS

40

 Order Number

ReferenceNumber001

payMethod

N

2

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




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




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

  • 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