Appearance
Create Transaksi
API ini digunakan untuk membuat transaksi baru dari layanan prabayar
. Anda bisa menggunakan endpoint berikut ini untuk memproses transaksi berdasarkan layanan yang telah dipilih dari daftar harga.
URL Endpoint
Gunakan metode POST
untuk mengakses endpoint berikut:
/transaksi/create
Headers
Pastikan untuk menyertakan header berikut dalam permintaan Anda:
Key | Value |
---|---|
Content-Type | application/x-www-form-urlencoded |
Catatan
Permintaan POST harus menggunakan format application/x-www-form-urlencoded.
Body
Untuk membuat permintaan transaksi, Anda perlu memasukkan beberapa parameter ke dalam body request. Berikut adalah daftar parameter yang diperlukan beserta penjelasan detailnya:
Field | Tipe | Wajib | Deskripsi |
---|---|---|---|
api_key | string | Ya | Kunci API untuk memastikan permintaan Anda sah dan diizinkan. |
code | string | Ya | Kode layanan dari daftar harga. |
reff_id | string | Ya | ID transaksi dari sistem Anda. |
target | string | Ya | Nomor atau ID pelanggan tujuan. |
limit_price | int | Tidak | Batas maksimum harga transaksi. |
Contoh Permintaan
Berikut adalah contoh permintaan HTTP POST menggunakan application/x-www-form-urlencoded
:
POST /transaksi/create HTTP/1.1
Host: atlantich2h.com
Content-Type: application/x-www-form-urlencoded
api_key=yourapikeyxxxxxxxxxxx&code=PLN50&reff_id=reffidexample123&target=0123456789&limit_price=52000
Contoh Respon
Jika permintaan berhasil, Anda akan menerima respon dari server dalam format JSON. Berikut adalah contoh respon yang mungkin Anda terima:
json
{
"status": true,
"message": "Transaksi diproses",
"data": {
"id": "xxxxxxxxxxxxxxxxx",
"reff_id": "reffidexample123",
"layanan": "PLN 50.000",
"code": "PLN50",
"target": "0123456789",
"price": "50000",
"sn": null,
"status": "pending",
"created_at": "2023-12-26 11:08:19"
},
"code": 202
}
Deskripsi Respon
Pada respon dari API transaksi, Anda akan menemukan informasi yang menggambarkan status dan detail dari transaksi yang telah diproses.
Field | Tipe | Deskripsi |
---|---|---|
status | boolean | Menyatakan apakah permintaan berhasil (true ) atau tidak (false ). |
message | string | Pesan yang menjelaskan hasil permintaan. |
data | object | Objek berisi informasi detail tentang transaksi. |
id | string | ID unik transaksi yang dibuat oleh sistem |
reff_id | string | ID transaksi dari sistem pengguna |
layanan | string | Nama layanan yang dipilih berdasarkan kode layanan |
code | string | Kode layanan dari daftar harga |
target | string | Nomor atau ID pelanggan tujuan transaksi |
price | string | Harga transaksi yang telah diproses |
sn | string | Nomor seri atau keterangan transaksi, bisa null jika belum tersedia |
status_transaksi | string | Status transaksi saat ini, terdapat kemungkinan failed ,pending ,success |
created_at | string | Tanggal dan waktu transaksi dibuat dalam format YYYY-MM-DD HH:MM:SS |
code_status | int | Kode status HTTP yang menunjukkan hasil permintaan. |