Skip to main content
POST
/
api
/
v1
/
cancel
Cancel Order
curl --request POST \
  --url https://app.sosmednext.com/api/v1/cancel \
  --header 'Content-Type: application/json' \
  --data '
{
  "orders": "<string>"
}
'
Gunakan endpoint ini untuk membatalkan satu atau beberapa pesanan yang masih dalam status pending atau processing. Saldo akan dikembalikan (refund) secara otomatis jika pembatalan berhasil diproses oleh provider.
Catatan: Tidak semua layanan mendukung pembatalan. Pesanan dengan status success atau canceled tidak dapat dibatalkan.

​
Body Parameters (JSON)

​
orders
string
required
ID Order yang ingin dibatalkan, dipisahkan koma. Maksimal 100 ID per request. Contoh: "9210,9211"

​
Contoh Request

curl -X POST \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orders": "9210,9211"}' \
  "https://app.sosmednext.com/api/v1/cancel"

​
Response

Response Sukses (200 OK)
[
  { "order": 9210, "cancel": 1 },
  { "order": 9211, "cancel": { "error": "Order already success" } }
]

​
Penjelasan Response:

FieldKeterangan
cancel: 1Pembatalan berhasil, saldo telah dikembalikan.
cancel: { error: "..." }Pembatalan gagal dengan pesan error.

​
Kemungkinan Pesan Error:

  • Order not found — ID order tidak ditemukan atau bukan milik Anda.
  • Order already success — Pesanan sudah selesai, tidak bisa dibatalkan.
  • Order already canceled — Pesanan sudah dibatalkan sebelumnya.
  • No provider data — Pesanan belum dikirim ke provider.