Hands On API NICEPAY - NICEPAY Docs

Hands On API
15min
Nikmati produk dan layanan NICEPAY dengan single integrated API dari kami yang aman serta mudah untuk integrasi dengan bisnis Anda. Mulai dengan proses integrasi yang cepat hanya dalam 15 menit!
Prasyarat
﻿
MID/iMid (Merchant ID).
API Key (Merchant Key).
NICEPAY SDK - Optional.
Silakan periksa prasyarat pada halaman Authentication﻿ terlebih dahulu.
﻿
Alur Pembayaran
﻿
Alur Pembayaran Checkout Credit Card
﻿
Deskripsi langkah alur pembayaran kartu kredit redirect dengan 3Ds: 
Pelanggan melakukan checkout.
Pelanggan mengirim data checkout kepada Merchant.
Merchant mengajukan checkout menggunakan API Registration kepada NICEPAY.
NICEPAY mendaftarkan data checkout.
NICEPAY mengalihkan pembayaran kepada halaman milik NICEPAY kepada Merchant.
Merchant mengirimkan halaman pembayaran NICEPAY kepada Pelanggan.
Pelanggan memilih metode pembayaran.
Pelanggan memasukkan data kartu.
Pelanggan mengirimkan Informasi data kartu kepada NICEPAY.
NICEPAY memproses kalkulasi FDS.
NICEPAY mengajukan 3Ds kepada Bank.
Bank melakukan validasi 3Ds.
Bank mengirimkan response URL 3Ds kepada NICEPAY.
NICEPAY menerima response verifikasi.
NICEPAY mengalihkan Pelanggan kepada halaman autentikasi ACS.
Bank membuat response OTP.
Bank mengirimkan OTP kepada Pelanggan.
Pelanggan menerima OTP.
Pelanggan memasukkan OTP.
Pelanggan mengirimkan OTP kepada Bank.
Bank melakukan verifikasi OTP.
Bank mengirimkan hasil 3Ds kepada NICEPAY.
NICEPAY menerima hasil pemeriksaan.
NICEPAY mengajukan pembayaran kepada Bank.
Bank melakukan proses pembayaran.
Bank mengirimkan notifikasi pembayaran kepada NICEPAY.
NICEPAY melakukan redirect callbackUrl kepada Merchant.
Merchant menampilkan hasil callbackUrl kepada Pelanggan.
NICEPAY mengirim notifikasi pembayaran kepada Merchant.
Merchant menerima notifikasi.
Merchant melakukan pengajuan inquiry ke NICEPAY.
NICEPAY menerima pengajuan.
NICEPAY secara otomatis mengirimkan response inquiry kepada Merchant.
Merchant menerima status terakhir.
Merchant mengirim halaman hasil transaksi kepada Pelanggan.
﻿
Integrasi Pembayaran
﻿
Dalam proses ini, Anda akan menggunakan produk Checkout﻿ kami. Seluruh transaksi pada Checkout API﻿ akan melakukan redirect ke NICEPAY Secure Payment Page sebagai proses pembayaran.
Ikuti lima langkah mudah di bawah ini untuk melakukan integrasi pembayaran dengan NICEPAY.
Melakukan panggilan API Transaction Registration.
Redirect ke NICEPAY Secure Payment Page.
Proses Pembayaran di NICEPAY Secure Payment Page.
NICEPAY akan melakukan redirect End-User ke callbackUrl Merchant.
Merchant melakukan panggilan API Status Inquiry API.
﻿
Transaction Registration
﻿
API End Point
﻿https://dev.nicepay.co.id/nicepay/redirect/v2/registration﻿
Request Method
﻿POST﻿
Header
Content-Type: application/json
Description
Perform Transaction Registration
Merchant Token
SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
Request
Response
{
    "timeStamp":"20221012080918",
    "iMid":"IONPAYTEST",
    "payMethod":"00",
    "currency":"IDR",
    "amt":"10000",
    "referenceNo":"ORDER20221012080918",
    "callBackUrl":"https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp",
    "goodsNm":"Test Transaction Nicepay",
    "billingNm":"John Doe",
    "billingPhone":"081288998899",
    "billingEmail":"[email protected]",
    "billingAddr":"Jln. Raya Kasablanka Kav.88",
    "billingCity":"South Jakarta",
    "billingState":"DKI Jakarta",
    "billingPostCd":"12800",
    "billingCountry":"Indonesia",
    "deliveryNm":"[email protected]",
    "deliveryPhone":"081288998899",
    "deliveryAddr":"Jln. Raya Kasablanka Kav.88",
    "deliveryCity":"South Jakarta",
    "deliveryState":"DKI Jakarta",
    "deliveryPostCd":"12800",
    "deliveryCountry":"Indonesia",
    "dbProcessUrl":"https://merchant.com/api/dbProcessUrl/Notif",
    "merchantToken":"d8d0968892c568bc6ff5adc17cd755f85334a0b58fce85392682993a9ba653ed",
    "userIP":"127.0.0.1",
    "cartData": "{\"count\":3,\"item\":[{\"goods_id\":30,\"goods_name\":\"Beanie\",\"goods_type\":\"Accessories\",\"goods_amt\":1000,\"goods_sellers_id\":\"NICEPAY-NamaMerchant\",\"goods_sellers_name\":\"NICEPAYSHOP\",\"goods_quantity\":1,\"goods_url\":\"http://www.nicestore.com/product/beanie/\"},{\"goods_id\":31,\"goods_name\":\"Belt\",\"goods_type\":\"Accessories\",\"goods_amt\":5000,\"goods_sellers_id\":\"NICEPAY-NamaMerchant\",\"goods_sellers_name\":\"NICEPAYSHOP\",\"goods_quantity\":1,\"goods_url\":\"http://www.nicestore.store/product/belt/\"},{\"img_url\":\"http://www.jamgora.com/media/avatar/noimage.png\",\"goods_name\":\"Shipping Fee\",\"goods_id\":\"Shipping for Ref. No. 278\",\"goods_detail\":\"Flat rate\",\"goods_type\":\"Shipping with Flat rate\",\"goods_amt\":\"4000\",\"goods_sellers_id\":\"NICEPAY-NamaMerchant\",\"goods_sellers_name\":\"NICEPAYSHOP\",\"goods_quantity\":\"1\",\"goods_url\":\"https://wwww.nicestore.store\"}]}",
    "sellers":"[{\"sellersId\":\"NICEPAY-NamaMerchant\",\"sellersNm\":\"NICEPAYSHOP\",\"sellersUrl\":\"http://nicestore.store/product/beanie/\",\"sellersEmail\":\"[email protected]\",\"sellersAddress\":{\"sellerNm\":\"NICEPAYSHOP\",\"sellerLastNm\":\"NICEPAYSHOP\",\"sellerAddr\":\"Jln. Kasablanka Kav 88\",\"sellerCity\":\"Jakarta\",\"sellerPostCd\":\"14350\",\"sellerPhone\":\"082111111111\",\"sellerCountry\":\"ID\"}}]",
    "instmntType": "2",
    "instmntMon": "1",
    "recurrOpt":"0",
    "bankCd":"",
    "mitraCd":"",
    "merFixAcctId":"",
    "vacctValidDt":"",
    "vacctValidTm":""
}
{
    "timeStamp":"20221012080918",
    "iMid":"IONPAYTEST",
    "payMethod":"00",
    "currency":"IDR",
    "amt":"10000",
    "referenceNo":"ORDER20221012080918",
    "callBackUrl":"https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp",
    "goodsNm":"Test Transaction Nicepay",
    "billingNm":"John Doe",
    "billingPhone":"081288998899",
    "billingEmail":"john.doe@example.com",
    "billingAddr":"Jln. Raya Kasablanka Kav.88",
    "billingCity":"South Jakarta",
    "billingState":"DKI Jakarta",
    "billingPostCd":"12800",
    "billingCountry":"Indonesia",
    "deliveryNm":"delivery@example.com",
    "deliveryPhone":"081288998899",
    "deliveryAddr":"Jln. Raya Kasablanka Kav.88",
    "deliveryCity":"South Jakarta",
    "deliveryState":"DKI Jakarta",
    "deliveryPostCd":"12800",
    "deliveryCountry":"Indonesia",
    "dbProcessUrl":"https://merchant.com/api/dbProcessUrl/Notif",
    "merchantToken":"d8d0968892c568bc6ff5adc17cd755f85334a0b58fce85392682993a9ba653ed",
    "userIP":"127.0.0.1",
    "cartData": "{\"count\":3,\"item\":[{\"goods_id\":30,\"goods_name\":\"Beanie\",\"goods_type\":\"Accessories\",\"goods_amt\":1000,\"goods_sellers_id\":\"NICEPAY-NamaMerchant\",\"goods_sellers_name\":\"NICEPAYSHOP\",\"goods_quantity\":1,\"goods_url\":\"http://www.nicestore.com/product/beanie/\"},{\"goods_id\":31,\"goods_name\":\"Belt\",\"goods_type\":\"Accessories\",\"goods_amt\":5000,\"goods_sellers_id\":\"NICEPAY-NamaMerchant\",\"goods_sellers_name\":\"NICEPAYSHOP\",\"goods_quantity\":1,\"goods_url\":\"http://www.nicestore.store/product/belt/\"},{\"img_url\":\"http://www.jamgora.com/media/avatar/noimage.png\",\"goods_name\":\"Shipping Fee\",\"goods_id\":\"Shipping for Ref. No. 278\",\"goods_detail\":\"Flat rate\",\"goods_type\":\"Shipping with Flat rate\",\"goods_amt\":\"4000\",\"goods_sellers_id\":\"NICEPAY-NamaMerchant\",\"goods_sellers_name\":\"NICEPAYSHOP\",\"goods_quantity\":\"1\",\"goods_url\":\"https://wwww.nicestore.store\"}]}",
    "sellers":"[{\"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\"}}]",
    "instmntType": "2",
    "instmntMon": "1",
    "recurrOpt":"0",
    "bankCd":"",
    "mitraCd":"",
    "merFixAcctId":"",
    "vacctValidDt":"",
    "vacctValidTm":""
}
﻿
Akses spesifikasi API lebih lengkap di Registration - API Checkout﻿.
﻿
Transaction Payment
﻿
API End Point
﻿https://dev.nicepay.co.id/nicepay/redirect/v2/payment﻿
Request Method
﻿GET﻿
Header
﻿Content-Type: application/Form-UrlEncoded﻿
Description
Perform Transaction Registration
Merchant Token
SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
Setelah mendapatkan response, Anda dapat mengalihkan Pelanggan menuju halaman pembayaran NICEPAY. Tautan tersebut merupakan penggabungan Response Parameter paymentURL+tXid https://dev.nicepay.co.id/nicepay/redirect/v2/payment?tXid=IONPAYTEST00202212191025073439.
Halaman Pembayaran NICEPAY Checkout
﻿
Contoh di atas merupakan Transaction Payment menggunakan metode pembayaran Kartu Kredit. Temukan spesifikasi API lebih lengkap di Credit Card - API Checkout﻿.
Halaman Pembayaran Berhasil
﻿
﻿
Callback Handling
﻿
Setelah User memilih metode pembayaran Kartu Kredit, User akan dikembalikan ke halaman Merchant callbackUrl dengan metode POST dan pengiriman parameter.
Callback Handling
﻿
Saat Callback diterima callbackUrl Anda, kami merekomendasikan Merchant untuk melakukan verifikasi Status dengan menggunakan Status Inquiry - API Credit Card﻿.
CallBack Handling sangat penting untuk membantu meminimalisir tindakan Fraud. Kami sangat merekomendasikan Merchant untuk melakukan verifikasi menggunakan callBack parameter 
callbackUrl
Callback Parameter
{
    "resultCd":"0000",
    "resultMsg":"SUCCESS",
    "tXid":"IONPAYTEST01202212141112221428",
    "referenceNo":"",
    "payMethod":"01",
    "amt":"10000",
    "transDt":"20221212",
    "transTm":"121212",
    "description":"Testing Credit Card Transaction",
    "authNo":"080623",
    "issuBankCd":"OTHR"
    "acquBankCd":"BMRI",
    "cardNo":"453211*****1111",
    "goodsNm":"Test Transaction Nicepay"
    "billingNm":"John Doe",
    "currency":"IDR",
    "timeStamp":"20221212121212",
    "merchantToken":"2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6",
    "cardExpYymm":"2712",
    "instmntMon":"1",
    "instmntType":"1",
    "ccTransType":"1"
}
{
    "resultCd":"0000",
    "resultMsg":"SUCCESS",
    "tXid":"IONPAYTEST01202212141112221428",
    "referenceNo":"",
    "payMethod":"01",
    "amt":"10000",
    "transDt":"20221212",
    "transTm":"121212",
    "description":"Testing Credit Card Transaction",
    "authNo":"080623",
    "issuBankCd":"OTHR"
    "acquBankCd":"BMRI",
    "cardNo":"453211*****1111",
    "goodsNm":"Test Transaction Nicepay"
    "billingNm":"John Doe",
    "currency":"IDR",
    "timeStamp":"20221212121212",
    "merchantToken":"2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6",
    "cardExpYymm":"2712",
    "instmntMon":"1",
    "instmntType":"1",
    "ccTransType":"1"
}
﻿
Selamat! Anda telah berhasil melakukan percobaan integrasi!
Jelajahi lebih jauh melalui tautan di bawah ini.
﻿
See Also
Temukan penjelasan terkait metode pembayaran dan produk kustomisasi pada halaman Payment﻿.
Temukan penjelasan terkait produk yang sudah disediakan NICEPAY pada halaman Checkout﻿.
Kunjungi halaman Payout﻿ untuk mempelajari produk terbaru NICEPAY.
Kunjungi halaman Messaging﻿ untuk mempelajari layanan mengirim pesan yang dimiliki NICEPAY.
﻿
Bank Indonesia telah menerbitkan Standar API terkait Pembayaran yang tercantum dalam Peraturan Anggota Dewan Gubernur No 23/15/PADG/2021 tentang Implementasi Standar Nasional Open Application Interface Pembayaran (SNAP).
Sebagai bentuk dukungan dan kepatuhan terhadap Peraturan Bank Indonesia, NICEPAY mendorong seluruh merchant untuk melakukan migrasi ke API SNAP BI.
Seluruh Merchant ditargetkan untuk dapat menyelesaikan migrasi API SNAP BI pada Juni 2024.
API End Point	https://dev.nicepay.co.id/nicepay/redirect/v2/registration
Request Method	POST
Header	Content-Type: application/json
Description	Perform Transaction Registration
Merchant Token	SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
API End Point	https://dev.nicepay.co.id/nicepay/redirect/v2/payment
Request Method	GET
Header	Content-Type: application/Form-UrlEncoded
Description	Perform Transaction Registration
Merchant Token	SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
Hands On API

Prasyarat

Alur Pembayaran

Integrasi Pembayaran

Transaction Registration

Transaction Payment

Callback Handling

See Also

Selamat Datang di NICEPAY DOCS
