Pesanan

Coba di Postman

Kelola pesanan Anda: buat, ambil, perbarui, dan daftar pesanan.

URL Utama: https://staging-api.xepeng.com/openapi/orders

staging

POST

Buat Pesanan

Buat pesanan baru dengan jumlah, mata uang, informasi pelanggan, dan metadata.

Parameter

Referensi	Tipe	Deskripsi
amount	angka	Jumlah yang harus dibayar (diperlukan).
currency	string	Kode mata uang, misal "IDR" (diperlukan).
customer	objek	Detail pelanggan: nama, email, telepon.
metadata	objek	Pasangan kunci-nilai kustom untuk referensi Anda.

Contoh Permintaan

curl --request POST "https://staging-api.xepeng.com/openapi/orders" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer {{api_key}}" \
  --data-raw '{
    "amount": 100000,
    "currency": "IDR",
    "description": "Order for product X",
    "customer": {
      "name": "John Doe",
      "email": "john.doe@example.com",
      "phone": "+6281234567890"
    },
    "metadata": {
      "order_ref": "ORDER-12345"
    }
  }'

PUT

Perbarui Pesanan

Perbarui pesanan yang ada berdasarkan UID-nya. Anda dapat memperbarui jumlah, deskripsi, atau metadata.
Endpoint: /openapi/orders/:order_uid

Contoh Permintaan

curl --request PUT "https://staging-api.xepeng.com/openapi/orders/ord_12345" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer {{api_key}}" \
  --data-raw '{
    "amount": 150000,
    "description": "Updated description"
  }'

GET

Ambil Pesanan

Ambil detail satu pesanan berdasarkan UID-nya.
Endpoint: /openapi/orders/:order_uid

Contoh Permintaan

curl --request GET "https://staging-api.xepeng.com/openapi/orders/ord_12345" \
  --header "Authorization: Bearer {{api_key}}"

GET

Daftar Pesanan

Daftar pesanan dengan dukungan paginasi.
Endpoint: /openapi/orders

Parameter Query

Parameter	Tipe	Deskripsi
page	integer	Nomor halaman (default: 1).
limit	integer	Item per halaman (default: 10).

Contoh Permintaan

curl --request GET "https://staging-api.xepeng.com/openapi/orders?page=1&limit=10" \
  --header "Authorization: Bearer {{api_key}}"