---
title: Credit Card - API Checkout
slug: nicepay-api-credit-card-payment-api-checkout
description: Informasi tentang API Checkout - Payment untuk metode pembayaran Kartu Kredit yang disediakan oleh NICEPAY
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/PYZcQ6O7AOKQ9qqxXLL2v_nicepay-docs-logo.png
icon: {"faIcon":"fa-solid fa-credit-card"}
docTags:
createdAt: 2022-12-19T10:12:43.000Z
---
# Tentang Credit Card - API Checkout
***
Terdapat beberapa hal yang Anda wajib ketahui dalam menggunakan API Checkout untuk metode Kartu Kredit agar proses integrasi Anda lancar bersama kami:
1. Proses Flow 3Ds/Non-3Ds.
2. Fitur Full Payment.
3. Fitur Installment.
# Alur Proses
***
:::hint{type="info"}
Silakan kunjungi halaman [Fitur Kartu Kredit](docId\:cgLxG10p9zmVtuX_-b7ga) untuk memeriksa penjelasan mengenai 3Ds.
:::
## 3Ds
Deskripsi langkah alur pembayaran Kartu Kredit *Redirect* dengan 3Ds:
1. Pelanggan melakukan *checkout*.
2. Pelanggan mengirim data checkout kepada Merchant.
3. Merchant mengajukan checkout menggunakan API Registration kepada NICEPAY .
4. NICEPAY mendaftarkan data checkout.
5. NICEPAY mengalihkan pembayaran pada halaman milik NICEPAY kepada Merchant.
6. Merchant mengirimkan halaman pembayaran NICEPAY kepada Pelanggan.
7. Pelanggan memilih metode pembayaran.
8. Pelanggan memasukkan data kartu.
9. Pelanggan mengirimkan informasi data kartu kepada NICEPAY.
10. NICEPAY memproses kalkulasi FDS.
11. NICEPAY mengajukan 3Ds kepada Bank.
12. Bank melakukan validasi 3Ds.
13. Bank mengirimkan *response *URL 3Ds kepada NICEPAY.
14. NICEPAY menerima *response *verifikasi.
15. NICEPAY mengalihkan Pelanggan kepada halaman autentikasi ACS.
16. Bank membuat *response *OTP.
17. Bank mengirimkan OTP kepada Pelanggan.
18. Pelanggan menerima OTP.
19. Pelanggan memasukkan OTP.
20. Pelanggan mengirimkan OTP kepada Bank.
21. Bank melakukan verifikasi OTP.
22. Bank mengirimkan hasil 3Ds kepada NICEPAY.
23. NICEPAY menerima hasil pemeriksaan.
24. NICEPAY mengajukan pembayaran kepada Bank.
25. Bank melakukan proses pembayaran.
26. Bank mengirimkan notifikasi pembayaran kepada NICEPAY.
27. NICEPAY melakukan *redirect* `callbackUrl` kepada Merchant.
28. Merchant menampilkan hasil `callbackUrl` kepada Pelanggan.
29. NICEPAY mengirim notifikasi pembayaran kepada Merchant.
30. Merchant menerima notifikasi.
31. Merchant melakukan pengajuan status inquiry ke NICEPAY.
32. NICEPAY menerima pengajuan.
33. NICEPAY secara otomatis mengirimkan *response *status inquiry kepada Merchant.
34. Merchant menerima status terakhir.
35. Merchant mengirim halaman hasil transaksi kepada Pelanggan.
## Non-3Ds
Deskripsi langkah alur pembayaran Kartu Kredit *Redirect* dengan Non-3Ds:
1. Pelanggan melakukan *checkout*.
2. Pelanggan mengajukan *checkout *kepada Merchant.
3. Merchant mendaftarkan data *checkout*.
4. Merchant mengirimkan *response *berupa formulir data kartu.
5. Pelanggan mengajukan *checkout *kepada Merchant.
6. Merchant mendaftarkan pesanan dengan menggunakan API Registration kepada NICEPAY.
7. NICEPAY menyimpan *order registration.*
8. NICEPAY mengalihkan Merchant kepada halaman NICEPAY.
9. Merchant mengirim halaman NICEPAY kepada Pelanggan.
10. Pelanggan memilih metode pembayaran.
11. Pelanggan memasukkan rincian kartu.
12. Pelanggan mengajukan pembayaran menggunakan API Payment kepada NICEPAY.
13. NICEPAY melakukan kalkulasi FDS.
14. NICEPAY mengajukan pembayaran kepada Bank.
15. Bank melakukan verifikasi pengajuan.
16. Bank mengirimkan pengajuan konfirmasi pembayaran kepada Pelanggan.
17. Pelanggan mengajukan pembayaran/*charge *kepada Bank.
18. Bank melakukan proses pembayaran.
19. Bank mengirim *response *pembayaran kepada NICEPAY.
20. NICEPAY mengirim notifikasi pembayaran menggunakan `callBackUrl` dan `dbProcessUrl` kepada Merchant.
21. Merchant menerima notifikasi.
22. Merchant mengajukan pemeriksaan status kepada NICEPAY.
23. NICEPAY mengirimkan *response *pemeriksaan status.
24. Merchant menerima status terakhir.
25. Merchant mengirimkan hasil pesanan kepada Pelanggan.
# NICEPAY Secure Payment Page
***
:::hint{type="info"}
Silakan membuka halaman [Panduan Bayar Kartu Kredit](docId\:pf0yYjEhAE07p65seIrFt) untuk dapat memberikan panduan pembayaran kepada Pelanggan Anda dalam metode Kartu Kredit.
:::
Gambar di atas adalah contoh pembayaran dengan metode Kartu Kredit menggunakan NICEPAY Secure Payment Page.
Setelah Pelanggan memilih metode dengan Kartu Kredit , Pelanggan akan diminta untuk memasukan data kartunya. Sistem NICEPAY akan secara otomatis mengenali jenis kartu BIN Pelanggan seperti gambar di bawah ini, misalnya VISA atau Mastercard, American Express, dan lain-lain yang nantinya kartunya pun akan berbeda sesuai dengan tipe jenis kartu yang digunakan.
Setelah selesai memasukkan data kartu, Pelanggan Anda dapat melanjutkan proses pembayaran.
Kemudian, proses transaksi akan berjalan. Apabila transaksi berhasil maka tampilan halaman pembayaran NICEPAY akan muncul seperti gambar berikut.
:::hint{type="info"}
Silakan kunjungi halaman [Payment - API Checkout](docId\:YnNFZr9aonpJ7ZIKAFYSx) untuk mengetahui langkah selanjutnya perihal `payment handling`.
:::
# API Checkout Transaction Payment
***
| **API URL** | `/nicepay/redirect/v2/payment`
|
| ------------------- | ------------------------------------------- |
| **Request Method** | `Redirect-GET` |
| **Header** | `Content-Type: application/Form-UrlEncoded` |
:::hint{type="info"}
*Endpoint* di atas dapat digunakan untuk metode pembayaran Kartu Kredit dengan tipe Full Payment.
:::
# Full Payment Credit Card - API Checkout (CallbackUrl)
***
Pada Full Payment Kartu Kredit, Pelanggan membayar secara penuh nominal yang ditagihkan dalam sekali bayar. Berikut adalah rincian API yang digunakan pada pembayaran Kartu Kredit.
## Request Parameter for Full Payment Credit Card - API Checkout (CallbackUrl)
***
| **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** |
| --------------------------------------------------------- | -------- | ---------- | --------------------- | ----------------------------------------------------------- |
| `paymentURL`
Required | ANS | 14 | Payment URL
| https\://dev.nicepay.co.id/nicepay/redirect/v2/payment
|
| `tXid`
Required | AN | 30 | Transaction ID
| IONPAYTEST00202203211640309389 |
:::hint{type="info"}
Untuk API Payment Checkout, metode pembayaran Kartu Kredit dengan Full Payment dan Installment mendapatkan *response* yang sama.
:::
## Response Parameter for Full Payment Credit Card - API Checkout (CallbackUrl)
***
| **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** |
| ---------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| `status` | N | 1 | [Transaction Status](docId:8m3-7Smhm_jhdrE5pCRzp) | 0 |
| `tXid` | AN | 30 | Transaction ID | IONPAYTEST00202212201540174369
When Success |
| `referenceNo` | AN | 40 | Merchant Order Number | ordNo20221220151243
When Success |
| `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 01
When Success |
| `amt` | N | 12 | Transaction Amount | 1000
When Success |
| `notaxAmt` | N | 12 | Tax Fee Amount | 0
When Success |
| `vat` | N | 12 | Value Added Tax (VAT) | 0
When Success |
| `fee` | N | 12 | Service Fee | 0
When Success |
| `currency` | A | 3 | Currency | IDR
When Success |
| `goodsNm` | AN | 100 | Goods Name | Goods+For+Testing+Credit+Card
When Success |
| `billingNm` | A | 100 | Billing Name | John+Doe
When Success |
| `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20221220
When Success |
| `transTm` | N | 6 | Transaction Time (`HH24MISS`) | 154017
When Success |
| `authNo` | N | 10 | Approval Number | 174300
When Success (Additional) |
| `issuBankCd` | A | 4 | [Issuing Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | BMRI
When Success |
| `acquBankCd` | A | 4 | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | BMRI
When Success |
| `issuBankNm` | A | 255 | Issuing Bank Name | Mandiri
When Success |
| `acquBankNm` | A | 255 | Acquiring Bank Name | Mandiri
When Success |
| `ccTransType` | AN
| 2 | Credit Card Transaction Type:
`1`: Normal
`2`: Recurring
`3`: Pre-Auth
`4`: Capture | 1
When Success |
| `cardNo` | ANS | 20 | Card Number With Masking | 46161111\*\*\*\*1111
When Success |
| `cardExpYymm` | N | 4 | Card Expiration (`YYMM`) | 2707
When Success |
| `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 1
When Success |
| `instmntMon` | N | 2 | Installment Month
`1`: 1 Month/Full Payment, jika `instmntType`*:* *null/1*
`3`: 3 Months
`6`: 6 Months
`12`: 12 Months | 1
When Success |
| `recurringToken` | AN | 255 | Recurring Token | null
When Success |
| `preauthToken` | AN | 255 | Pre-Auth Token | null
When Success |
| `matchCl` | N | 1 | [Notification Match Amount Indicator](docId\:WdoGjBeqc1VmRdFJqG1ZE) | 1
When Success |
| `merchantToken` | AN | 255 | Merchant Token | 8f5b330a549c167b53b4b9fd5f2d2eba897a64235c1610524074ec59f8884e8a
When Success |
## Sample Parameter for Full Payment Credit Card - API Checkout (CallbackUrl)
***
### Request Parameter
:::CodeblockTabs
cURL
```curl
curl -X GET "https://www.merchant.com/callbackUrl?ccTransType=1&fee=0&tXid=IONPAYTEST00202212201540174369&amt=1000¬axAmt=0&cardNo=46161111****1111&issuBankCd=BMRI&matchCl=1&preauthToken=null&cardExpYymm=2603&acquBankNm=Mandiri&payMethod=01¤cy=IDR&instmntMon=1&cc_trans_type=1&issuBankNm=Mandiri&merchantToken=dc1dd9e57ff6c4db341654ae31e623cab4d4d8057b2d0b58bef43ccb0da3b494&goodsNm=Goods+For+Testing+Credit+Card&referenceNo=ordNo20221220151243&authNo=174300&transTm=154017&cpGuaranteeableStatus=null&recurringToken=null&vat=0&instmntType=1&billingNm=John+Doe&acquBankCd=BMRI&transDt=20221220&status=0"
```
:::
### Callback Parameter
:::CodeblockTabs
Response Callback
```curl
status=0
tXid=IONPAYTEST00202212201540174369
referenceNo=ordNo20221220151243
payMethod=01
amt=1000
notaxAmt=0
vat=0
fee=0
currency=IDR
goodsNm=Goods+For+Testing+Credit+Card
billingNm=John+Doe
transDt=20221220
transTm=154017
authNo=174300
issuBankCd=BMRI
acquBankCd=BMRI
issuBankNm=Mandiri
acquBankNm=Mandiri
ccTransType=1
cardNo=46161111****1111
cardExpYymm=2707
instmntType=1
instmntMon=1
recurringToken=null
preauthToken=null
matchCl=1
merchantToken=8f5b330a549c167b53b4b9fd5f2d2eba897a64235c1610524074ec59f8884e8a
```
:::
:::hint{type="info"}
Catatan: Response parameter akan dikirimkan melalui `callBackurl` dengan Content-type: `application/json` dan metode: `POST Parameter`.
:::
:::hint{type="success"}
Untuk proses integrasi Payment pada Checkout API, *response* dari *request *yang didapat setelah melakukan API Call Request adalah Callback URL.
:::
## Callback Handling API Checkout Transaction Payment
***
:::hint{type="info"}
`tXid` tidak akan sama dengan *request hold. *Proses Capture akan memastikan bahwa nilai `amount` yang di-*capture* tidak melebihi dana yang dimiliki.
:::
:::hint{type="success"}
Saat *Callback *diterima `callbackUrl` Anda, kami merekomendasikan Merchant untuk melakukan verifikasi Status dengan menggunakan [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3).
:::
:::hint{type="warning"}
`Callback Handling` sangat penting untuk membantu meminimalisir tindakan *Fraud*. Kami sangat merekomendasikan Merchant untuk melakukan verifikasi menggunakan `Callback parameter`.
:::
::Image[]{src="https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/ccwlMZjgo0gOioQqjK2oO_nicepay-api-checkout-api-callback-handling-flow-1.png" size="60" width="370" height="361" position="center" caption="Alur Callback Handling" alt="Alur Callback Handling" darkWidth="370" darkHeight="361" showCaption="true"}
:::CodeblockTabs
URL Callback
```json
"callbackUrl" : "https://www.merchant.com/callbackUrl/"
```
Response Callback
```json
{
"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"
}
```
:::