Credit Card

Tokenization

Tokenization adalah layanan yang digunakan untuk melakukan pembayaran otomatis (autodebit) tanpa memasukkan ulang informasi kartu kredit untuk setiap transaksi. Melalui Tokenization, data sensitif kartu kredit customer, seperti nomor kartu, diubah menjadi token unik yang aman dan hanya dapat digunakan dalam sistem tertentu. Token ini dihasilkan ketika customer melakukan pembayaran menggunakan kartu kredit. Setelah token kredit tersebut tersimpan, token ini dapat digunakan untuk transaksi berulang tanpa menyimpan atau memproses data kartu kredit secara langsung, sehingga meningkatkan keamanan dan efisiensi dalam proses pembayaran.

Flow

Anda melakukan permintaan dengan mengirimkan parameter yang dibutuhkan, dan Espay Payment Gateway akan memberikan respons dalam bentuk JSON.

Key Value
Method
HTTP Post
Connection
keep-alive
Content-Length
250
Content-Type
application/x-www-form-urlencoded
Accept
*/*

API URL

Environment URL
Sandbox
https://sandbox-api.espay.id/rest/creditcard/tokenpayment
Production
https://api.espay.id/rest/creditcard/tokenpayment

Parameter Permintaan

Parameter Tipe Mandatory Keterangan
rq_uuid
String (64)
Y
Universally Unique Identifier (UUID), nomor unik yang digunakan untuk mengidentifikasi pesan.
rq_datetime
String (19)
Y
Tanggal dan waktu transaksi yang dikirim dari server merchant.
comm_code
String (32)
Y
Merchant code yang diberikan oleh tim Espay.
masked_card_no
String (20)
Y
Nomor kartu yang dimasking.
store_card_number
String (20)
Y
Token yang diberikan oleh Espay.
trx_id
String (32)
Y
Kode unik untuk mengidentifikasi pesanan / penagihan / faktur.

Contoh:
Nomor transaksi, invoice id, dll.
description
String (19)
Y
Deskripsi transaksi.
cardname
String (32)
Y
Nama pemilik kartu kredit.
email
String (32)
Y
Alamat email pemilik kartu kredit.
ccy
String (5)
Y
Kode mata uang transaksi.

Format:
  • Rupiah: IDR
amount
String (20)
Y
Jumlah pembayaran.
call_back_url
String (32)
O
URL callback.
signature
String (64)
Y
Kode yang digunakan untuk melakukan validasi transaksi. Pelajari Payment Gateway | Hash-Based Signature.

Parameter Respons

Parameter Tipe Mandatory Keterangan
rq_uuid
String (4)
Y
Universally Unique Identifier (UUID), nomor unik yang digunakan untuk mengidentifikasi pesan.
rs_datetime
String (32)
Y
Tanggal dan waktu transaksi yang dikirim dari server Espay.
trx_id
String (32)
Y
Kode unik untuk mengidentifikasi pesanan / penagihan / faktur.

Contoh:
Nomor transaksi, invoice id, dll.
error_code
String (4)
Y
Kode respon.

Format:
  • Permintaan berhasil (success): 0000
  • Permintaan gagal (failed):9999
error_message
String (32)
Y
Deskripsi respons.





































Contoh Request

POST /rest/creditcard/tokenpayment HTTP/1.1
Host: sandbox-api.espay.id
Connection: keep-alive
Content-Length: 250
Content-Type: application/x-www-form-urlencoded
Accept: */*

rq_uuid:SGWHMSAMPOERNAfcf63291-9681-4934-8103-fe9598b5fddd
rq_datetime:2021-10-12 15:17:00
comm_code:SGWHMSAMPOERNA03
masked_card_no:411111XXXXXX1111
store_card_number:13051910361234614100
trx_id:DIGORDER000001
description:Pembelian Iqos
cardname:test
email:[email protected]
ccy:IDR:
amount:10000
signature:d59c9333f478457a357bdf1fd12ce07cbf0ec9ed29c18b521f5f37f4327879d3




























Contoh Respons Positif

{
  "rq_uuid":"SGWHMSAMPOERNAfcf63291-9681-4934-8103-fe9598b5fddd",
  "rs_datetime":"2021-10-12 15:17:16",
  "trx_id":"DIGORDER000001",
  "error_code":"0000",
  "error_message":"Success"
}


Contoh Respons Negatif

{
    "trx_id": "DIGORDER000001",
    "error_code": "11",
    "error_message": "Credential is not Valid"
}



HTTP

POST /rest/creditcard/tokenpayment HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/x-www-form-urlencoded
Content-Length: 381

rq_uuid=SGWHMSAMPOERNAfcf63291-9681-4934-8103-fe9598b5fddd&rq_datetime=2021-10-12%2015%3A17%3A00&comm_code=SGWHMSAMPOERNA03&masked_card_no=411111XXXXXX1111&store_card_number=13051910361234614100&trx_id=DIGORDER000001&description=Pembelian%20Iqos&cardname=test&email=test%40sgo.co.id&ccy=IDR%3A&amount=10000&signature=d59c9333f478457a357bdf1fd12ce07cbf0ec9ed29c18b521f5f37f4327879d3



CURL

curl --location 'https://sandbox-api.espay.id/rest/creditcard/tokenpayment' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'rq_uuid=SGWHMSAMPOERNAfcf63291-9681-4934-8103-fe9598b5fddd' \
--data-urlencode 'rq_datetime=2021-10-12 15:17:00' \
--data-urlencode 'comm_code=SGWHMSAMPOERNA03' \
--data-urlencode 'masked_card_no=411111XXXXXX1111' \
--data-urlencode 'store_card_number=13051910361234614100' \
--data-urlencode 'trx_id=DIGORDER000001' \
--data-urlencode 'description=Pembelian Iqos' \
--data-urlencode 'cardname=test' \
--data-urlencode '[email protected]' \
--data-urlencode 'ccy=IDR:' \
--data-urlencode 'amount=10000' \
--data-urlencode 'signature=d59c9333f478457a357bdf1fd12ce07cbf0ec9ed29c18b521f5f37f4327879d3'
Scroll to Top