Skip to content

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:

KeyValue
Content-Typeapplication/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:

FieldTipeWajibDeskripsi
api_keystringYaKunci API untuk memastikan permintaan Anda sah dan diizinkan.
codestringYaKode layanan dari daftar harga.
reff_idstringYaID transaksi dari sistem Anda.
targetstringYaNomor atau ID pelanggan tujuan.
limit_priceintTidakBatas 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.

FieldTipeDeskripsi
statusbooleanMenyatakan apakah permintaan berhasil (true) atau tidak (false).
messagestringPesan yang menjelaskan hasil permintaan.
dataobjectObjek berisi informasi detail tentang transaksi.
idstringID unik transaksi yang dibuat oleh sistem
reff_idstringID transaksi dari sistem pengguna
layananstringNama layanan yang dipilih berdasarkan kode layanan
codestringKode layanan dari daftar harga
targetstringNomor atau ID pelanggan tujuan transaksi
pricestringHarga transaksi yang telah diproses
snstringNomor seri atau keterangan transaksi, bisa null jika belum tersedia
status_transaksistringStatus transaksi saat ini, terdapat kemungkinan failed,pending,success
created_atstringTanggal dan waktu transaksi dibuat dalam format YYYY-MM-DD HH:MM:SS
code_statusintKode status HTTP yang menunjukkan hasil permintaan.