Push 2 Payment





Download Image

Push to Pay

Push Payment merupakan platform pembayaran berupa e-money dalam bentuk aplikasi mobile dengan keunikan langsung tersambung dengan akun aplikasi pengguna. Dengan pembayaran push, pembeli menerima dan menyetujui faktur dan mengirimkan pembayaran seperti halnya dengan pembayaran tarikan. Namun, dengan pembayaran push, proses transaksi secara otomatis dan dana dimasukkan langsung ke akun penjual. ACH, pembayaran rekening dan setoran langsung adalah contoh pembayaran push. Karena ada biaya transaksi yang lebih rendah dan proses rekonsiliasi yang lebih mudah, pembayaran push sering dimanfaatkan untuk meyakinkan pemasok untuk menerima pembayaran kartu kredit.

Dalam ranah menuju digitalisasi, Pembayaran akan semakin dipermudah untuk kedepannya. Seperti dengan metode pembayaran PUSH2PAY ini, ESPAY secara tidak langsung mengajak para pengguna / pelanggannya untuk semakin dekat dengan era digitalisasi melalui internet dan ponsel pintar. Selain itu, pengguna juga mendapatkan kelebihan-kelebihan seperti:

  • Pembayaran yang ramah pengguna (Sangat MUDAH, sungguh!)
  • Pembayaran yang lebih aman
  • Pengalaman yang lebih baik untuk pengguna

Dengan metode pembayaran ini, entitas-entitas yang sebelumnya diperlukan seperti:

before

Berubah Menjadi

after

Dengan kemudahan yang diberikan dalam pembayaran menjadikan aktivitas transaksi semakin menyenangkan. Memberikan pengguna sebuah pengalaman bertransaksi yang jauh lebih baik dari sebelumnya.

“Metode pembayaran yang akan MENGUBAH pengalaman bertransaksi”

Web Service untuk melakukan Push to Pay ke Aplikasi Pembayaran

Alur Pesan

Merchant → Espay

Metode

HTTP Post

API URL

Endpoint Development: https://sandbox-api.espay.id/rest/digitalpay/pushtopay
Endpoint Production: https://api.espay.id/rest/digitalpay/pushtopay


Parameter Request:
Nama Field Attribute Mandatory Keterangan
rq_uuid 64 Ya Pengidentifikasi request. ID unik untuk mengidentifikasi pesan-pesan tersebut dengan pesan yang lain
rq_datetime 19 Ya Tanggal dan waktu di server aplikasi Espay ketika pesan dikirim
comm_code 10 Ya Kode penjual yang terdaftar di aplikasi Espay
order_id 20 Ya Nomor transaksi / ID faktur / ID unik yang mengidentifikasi pesanan / tagihan / faktur
product_code 10 Ya Kode Produk yang diinginkan.
  1. OVO
  2. JENIUS
  3. GOPAY
  4. LINKAJA
amount 13 Ya Jumlah tagihan yang harus dibayarkan
customer_id 64 Ya Data customer
  1. OVO = Nomor Handphone
  2. JENIUS = Cashtag ($cashtag)
  3. GOPAY = Nomor Handphone
  4. LINKAJA = Nomor Handphone
promo_code 64 Tidak Promo Code
is_sync 1 Tidak 1 = Sync / 0 = Async Default Async
branch_id 64 Optional Branch ID
pos_id 64 Optional POS ID Machine
signature 64 Ya Signature diperlukan untuk validasi oleh penjual

Parameter Respone:
Nama Field Attribute Mandatory Keterangan
error_code 4 Ya Jika error_code sama dengan 0000 = Sukses
Jika error_code tidak sama dengan 0000 = Gagal call request ke Aplikasi Pembayaran
error_message 32 Ya Jika error_code sama dengan 0000 = Sukses
Jika error_code tidak sama dengan 0000 = Gagal call request ke Aplikasi Pembayaran
trx_id 32 Ya Transaksi ID dari Espay
QRLink 64 Ya URL QR https://api.espay.id/gojek/QR/uafu-134fd-erdf-353--erdf-353-/
QRCode BLOB Ya data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGB
gcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UxwcKDcpLDAxNDQ0Hyc5PTgyP…..
order_id 20 Optional Nomor transaksi / ID faktur / ID unik yang mengidentifikasikan pesanan / tagihan / faktur
customer_id 32 Optional Data customer
  1. OVO = Nomor Handphone
  2. JENIUS = Cashtag ($cashtag)
  3. GOPAY = Nomor Handphone
  4. LINKAJA = Nomor Handphone
trx_status 2 Optional Status transaksi
amount 13 Optional Jumlah tagihan
approval_code 64 Optional Approval code, reference dari Bank
product_code 10 Optional Kode product

Signature

Setiap request harus dilengkapi signature untuk divalidasi. Client akan diberikan Secret Key di dokumentasi terpisah dari document ini. Key tersebut akan diolah untuk menjadi signature dengan langkah-langkah sebagai berikut :

Step 1 :
Gabungkan parameter-parameter yang digunakan dengan urutan sebagai berikut :

##rq_uuid##comm_code##product_code##order_id##amount##key##

Contoh :

rq_uuid : 123ABC-DEF456
comm_code : MYCOMMCODE
product_code : OVO
order_id : ORDER001
amount : 10000
key : S3cr317kEY

Sehingga akan menjadi rangkaian string sebagai berikut :

Result = ##123ABC-DEF456##MYCOMMCODE##OVO##ORDER001##10000##S3cr317kEY##

Step 2 :
Hasil dari Step 1 di uppercase menjadi seperti ini:

##123ABC-DEF456##MYCOMMCODE##OVO##ORDER001##10000##S3CR317KEY##

Step 3 :
Hash hasil dari Step 2 dengan menggunakan sha256 :

$sha256 = hash(sha256, '##123ABC-DEF456##MYCOMMCODE##OVO##ORDER001##10000##S3CR317KEY##')

Result = aa19e37e1bf6d5cfb23d59988d397f9ba6e79cf6853606e45a6809e0ca9a7b5d

Hasil dari Step 3 inilah yang akan digunakan sebagai value dari parameter signature.






































































































Signature
Contoh Request:

POST /rest/digitalpay/pushtopay HTTP/1.1 Content-Length: 282 Content-Type: application/x-www-form-urlencoded Accept: */*Host: sandbox-api.espay.id Authorization: Basic U0dXUEFJREJBUTAyOkhOUlFLSENI rq_uuid=PAIDBAQ721659 &rq_datetime=2019-11-02 01:29:10 &comm_code=SGWPAIDBAQ02 &product_code=OVO &order_id=ESP.0043330 &amount=105000 &key=27hsdfv6ukmepgrv &description=Customer PaidbaQ &customer_id=081223213625 &signature=89c1ac1cdbb30185bcab457f209ba90ef43486216823abfe7ed013b24ee49733
















signature
Contoh Response:

{ "rq_uuid": "PAIDBAQ721659", "rs_datetime": "2019-11-02 01:29:21", "error_code": "0000", "error_message": "", "trx_id": "ESP1572632951KJTO" } { "rq_uuid": "0be6ff4a-9dd0-4177-b576-58740482d230", "rs_datetime": "2019-06-13 14:29:34", "error_code": "0000", "error_desc": "Success", "reference_id": "ESP1560410968IUAD", "customer_id": "$getha6", "order_id": "SGWYESSI000012", "trx_id": "ESP1560410968IUAD", "trx_status": "S", "amount": "10000", "approval_code": "1522064295", "product_code": "JENIUSIB" }