Hands On API

14 min

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 API Checkout 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)

{
    "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":""
}

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.

NICEPAY Payment Page

Contoh di atas merupakan Transaction Payment menggunakan metode pembayaran Kartu Kredit. Temukan spesifikasi API lebih lengkap di Credit Card - API Checkout.

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.

{
    "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.

Hands On API

Prasyarat

Alur Pembayaran

Integrasi Pembayaran

Transaction Registration

Transaction Payment

Callback Handling

See Also

Selamat Datang di NICEPAY DOCS