API Developer Guide

PendahuluanChannel PembayaranPembuatan SignatureVirtual AccountQRIS

Pendahuluan

Selamat datang di halaman Dokumentasi API. Disini telah disediakan penjelasan lengkap mengenai daftar API yang tersedia dan cara akses/penggunaan dari masing-masing API.

Channel pembayaran kami menggunakan Closed Payment:

  • Nominal pembayaran ditentukan oleh merchant.
  • 1 Kode Bayar/Nomor Virtual Account hanya dapat digunakan sekali.
  • Biaya transaksi dapat dibebankan ke merchant atau ke pelanggan.

Channel Pembayaran

  • Virtual Account
  • QRIS

Pembuatan Signature

Untuk melakukan request transaksi, anda harus membuat signature yang akan divalidasi sistem Sidpay untuk memastikan integritas data dan pengirim saat ditransmisikan ke sistem Sidpay.

<?php

$private_key = 'd3a957cb1444ea09bfed608c9787341fb641fb';
$merchant_code = 'SID0003';
$jsoned_body = '{"amount":"100","applicationType":"WEB","merchantURL":"https:/billing.sid.net.id/api/payment-callback","issuer":"OTTOCASH","failedURL":"https://billing.sid.net.id/api/payment-callback","successURL":"https://billing.sid.net.id/api/payment-callback","promoCode":"0","trxRef":"00123","userId":"087715724411"}';

$signature = hash_hmac('sha256', $merchant_code.$jsoned_body, $private_key);

// Result
// fbc26033e0afeecf0d395602ab22539041bb9594ccbb1463e5452d11e7a38c6c

?>

Virtual Account

API ini digunakan untuk membuat transaksi baru atau melakukan generate kode pembayaran.

Request

  • Method : POST
  • URL :  https://sidpay.id/api/va/create
  • Authorization :  Bearer {api_key} (Ganti {api_key} dengan API Key merchant anda)
  • Signature :  Kode validasi (Lihat pada menu pembuatan signature)


{
	​"bank": "BRIVA", // BRIVA, MANDIRIVA, BCA, BINA, PERMATA, BNI
	​"customer_number": "12345",
	​"customer_name": "John Doe",
	​"nominal": "10001", // 10.001 is minimum transaction for VA
	​"description": null
}
  • amount
  • applicationType 
  • merchantURL 
  • issuer 
  • failedURL 
  • successURL 
  • promoCode 
  • trxRef 
  • userId

Response


{
	​"responseCode": "00",
	​"responseDesc": "SUCCESS",
	​"qrData": "00020101021226640015ID.OTTOCASH.WWW01189360081110019777590212OP1D012885820303UME51440014ID.CO.QRIS.WWW0215ID10243321718410303UME52045262530336054031005802ID5907SID NET6015Gedung BITC, Jl61054052162710119BILL0714194173194980521SP17309639818780444760703A019612OP1D012885826304E79D",
	​"expired_date": "2024-11-07 17:19:42"
}


{
	​"error": "Invalid Signature"
}
  • amount
  • applicationType 
  • merchantURL 
  • issuer 
  • failedURL 
  • successURL 
  • promoCode 
  • trxRef 
  • userId

QRIS

API ini digunakan untuk membuat transaksi baru atau melakukan generate kode pembayaran.

Request

  • Method : POST
  • URL :  https://sidpay.id/api/qris/create
  • Authorization :  Bearer {api_key} (Ganti {api_key} dengan API Key merchant anda)
  • Signature :  Kode validasi (Lihat pada menu pembuatan signature)


{
	​"amount": "100",
	​"applicationType": "WEB",
	​"merchantURL": "https://8004-103-148-112-245.ngrok-free.app/api/payment-callback",
	​"issuer": "OTTOCASH",
	​"failedURL": "https://8004-103-148-112-245.ngrok-free.app/api/payment-callback",
	​"successURL": "https://8004-103-148-112-245.ngrok-free.app/api/payment-callback",
	​"promoCode": "0",
	​"trxRef": "00223",
	​"userId": "087715724411"
}
  • amount
  • applicationType 
  • merchantURL 
  • issuer 
  • failedURL 
  • successURL 
  • promoCode 
  • trxRef 
  • userId

Response


{
	"message": "Transaction Not Found"
}
  • amount
  • applicationType 
  • merchantURL 
  • issuer 
  • failedURL 
  • successURL 
  • promoCode 
  • trxRef 
  • userId