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/createHeaders
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=52000Contoh 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. |
