Credit Card

Create Credit Card Order

Panduan lengkap untuk membuat pesanan kartu kredit melalui API Paylabs.

Request URL

URL: ${ROOT_URL}/payment/v2.3/cc/create

HTTPMethod: POST

EndpointUrl: /payment/v2.3/cc/create

Create Credit Card Order Request Parameters

Cara Membuat Signature

Field NameTypeValueRequired
Content-TypeString(30)Isi dengan nilai "application/json;charset=utf-8"Yes
X-TIMESTAMPString(29)Waktu saat ini, dengan format 2022-09-16T16:58:47.964+07:00Yes
X-SIGNATUREString(64)Signature. Untuk selengkapnya cekYes
X-PARTNER-IDString(20)Merchant IDYes
X-REQUEST-IDString(64)ID unik merepresentasikan setiap request yang dikirimYes

Body

ParameterTypeRequiredRemarks
requestIdString(64)YesKode unik untuk setiap request
merchantIdString(20)YesID unik yang disediakan oleh payment gateway ke merchant
storeIdString(30)NoJika Merchant memiliki cabang dan ingin membuat order dengan ID cabang
paymentTypeString(20)YesNama tipe pembayaran, cek tabel Tipe Pembayaran
amountDecimal(12,2)YesNominal dalam Rupiah Indonesia
merchantTradeNoString(32)YesKode unik yang dibuat oleh Merchant untuk setiap transaksi
notifyUrlString(200)NoURL yang akan ditembak saat terjadi pembayaran. Untuk parameter-parameternya cek di bagian Inquiry Order
+paymentParamsObjectNoParameter tambahan khusus untuk channel tertentu. Mohon cek tabel Tipe Pembayaran.
productNameString(100)YesNama layanan atau produk
+productInfoArray<Object>(30)NoInformasi detil atas produk atau layanan dalam transaksi
a?OidString(10)YesProduct ID
a?OnameString(32)YesProduct Name
a?Opricedecimal(12,2)YesNilai dalam Rupiah, mendukung dua angka belakang koma
a?OtypeString(20)YesProduct Type
a?OurlString(200)NoProduct URL
a?OquantityNumber(4)YesProduct Quantity
feeTypeString(3)NoJenis pengurangan biaya layanan:BEN�OUR. Standarnya BEN. Ketika OUR dipilih, biaya layanan akan ditambahkan otomatis ke nominal order.

paymentType

Payment TypeCode
Credit Card 3D-SecureCreditCard
Credit Card 2D-SecureCreditCard_2DSecure
Installment (6 Months)CreditCard_6Mos
Installment (12 Months)CreditCard_12Mos

paymentParams

ParameterTypeRequiredRemarks
redirectUrlString(200)YesTarget URL untuk redirection setelah order berhasil/gagal

Create Credit Card Order Response Parameters

Header

Cara Membuat Signature

Field NameTypeValueRequired
Content-TypeString(30)Isi dengan nilai "application/json;charset=utf-8"Yes
X-TIMESTAMPString(29)Waktu saat ini, dengan format 2022-09-16T16:58:47.964+07:00Yes
X-SIGNATUREString(64)Signature. Untuk selengkapnya cekYes
X-PARTNER-IDString(20)Merchant IDYes
X-REQUEST-IDString(64)ID unik merepresentasikan setiap request yang dikirimYes

Body

Kode Error

ParameterTypeRequiredRemarks
requestIdString(64)YesKode unik untuk setiap request
errCodeString(32)Yes0 adalah sukses, untuk lainnya bisa lihat tabel
errCodeDesString(128)NoDeskripsi terkait error
merchantIdString(20)YesMerchant ID
storeIdString(30)NoJika Merchant memiliki cabang dan ingin membuat order dengan ID cabang
paymentTypeString(20)YesNama tipe pembayaran, cek tabel Tipe Pembayaran
requestAmountDecimal(12,2)NoNominal pada saat permintaan
amountDecimal(12,2)YesNominal dalam Rupiah Indonesia, with 2 decimal placesJenis pengurangan biaya layanan:Ketika OUR dipilih, biaya layanan akan ditambahkan ke nominal order. Ketika biaya layanan yang dihitung mengandung desimal, biaya layanan akan otomatis +1 setelah menghilangkan desimal. Misalnya, 10.000,11 akan secara otomatis +1 untuk mendapatkan 10.001,00.
merchantTradeNoString(32)YesKode unik yang dibuat oleh Merchant untuk setiap transaksi
createTimeString(16)NoyyyyMMddHHmmss
+paymentActionsObjectNoInformasi URL pembayaran yang bisa berupa URL PC, URL Web dan lainnya.
a?OpayUrlString(200)NoPayment URL
platformTradeNoString(32)NoNomor order di platform Paylabs
successTimeString(16)NoyyyyMMddHHmmss
expiredTimeString(16)NoyyyyMMddHHmmss
statusString(32)No01: Pending, 09: Failed, 02: Success
productNameString(100)YesNama layanan atau produk
+productInfoArray<Object>(30)NoInformasi detil atas produk atau layanan dalam transaksi
a?OidString(10)YesProduct ID
a?OnameString(32)YesProduct Name
a?Opricedecimal(12,2)YesNilai dalam Rupiah, mendukung dua angka belakang koma
a?OtypeString(20)YesProduct Type
a?OurlString(200)NoProduct URL
a?OquantityNumber(4)YesProduct Quantity
transFeeRateDecimal(6,6)NoRate Transaksi, mendukung enam angka belakang koma
transFeeAmountDecimal(12,2)NoBiaya, mendukung dua angka belakang koma
totalTransFeeDecimal(12,2)NoTotal rate biaya layanan transaksi (tidak termasuk vatFee), mendukung dua angka belakang koma
vatFeeDecimal(12,2)NoPajak, mendukung dua angka belakang koma

Example

Request

POST /payment/v2.3/cc/create
# HTTP Header
Content-Type: application/json;charset=utf-8
X-TIMESTAMP: 2022-09-16T16:58:47.964+07:00
X-SIGNATURE: xxxxxxxxx
X-PARTNER-ID: 010001
X-REQUEST-ID: xxxxxxxxxxxxxxxxxxxxxxxx

# HTTP Body
{
  "merchantId":"0010001",
  "merchantTradeNo":"100100011649751697607",
  "requestId":"100100011649751697607",
  "paymentType":"CreditCard",
  "amount":"10000.00",
  "productName":"Test",
  "paymentParams":{
            "redirectUrl": "http://google.com"
        }
}

Response

POST /payment/v2.3/cc/create
# HTTP Header
Content-Type: application/json;charset=utf-8
X-TIMESTAMP: 2022-09-16T16:58:47.964+07:00
X-SIGNATURE: xxxxxxxxx
X-PARTNER-ID: 010001
X-REQUEST-ID: xxxxxxxxxxxxxxxxxxxxxxxx

# HTTP Body
{
  "amount":"10000.00",
  "merchantTradeNo":"T00100011649751697607",
  "platformTradeNo":"2022041200000000015",
  "expiredTime":"20220413152138",
  "paymentType":"CreditCard",
  "paymentActions":{
            "payUrl":"http://192.168.0.119:8081/en-credit-index.html?k=c2b2da7c8ce8b00691a68c38d77e000eeec0f030655f06a93eeeee051ca3235024591ab3207f9a39e58e4082d2b6f922"
        },
  "createTime":"20220412152138",
  "merchantId":"0010001",
  "errCode":"0",
  "requestId":"R00100011649751697607",
  "productName":"Test",
  "status":"01",
  "transFeeRate":"0",
  "transFeeAmount":"0",
  "totalTransFee":"0",
  "vatFee":"0"
}