Welcome to Xendit’s latest documentation. For legacy content, access the previous documentation here or the previous API reference here.

Batalkan pembayaran

Prev Next

Membatalkan otorisasi, atau dikenal juga sebagai void, adalah proses pelepasan penahanan sementara dana pelanggan sebelum transaksi diselesaikan (ditangkap/captured). Ini secara efektif membalikkan otorisasi, mencegah tagihan diproses.

Ini relevan dalam situasi berikut:

  • Pembatalan pelanggan: Pelanggan berubah pikiran dan membatalkan pesanan sebelum Anda menangkap pembayaran.

  • Item kehabisan stok: Anda menemukan bahwa barang yang dipesan pelanggan kehabisan stok dan tidak dapat memenuhi pesanan.

  • Kesalahan penetapan harga: Anda menyadari bahwa ada kesalahan penetapan harga pada produk atau layanan dan tidak ingin membebankan biaya yang salah kepada pelanggan.

  • Kecurigaan penipuan: Anda menduga bahwa transaksi tersebut mungkin penipuan dan ingin menyelidiki lebih lanjut sebelum menangkap pembayaran.

  • Transaksi duplikat: Anda secara tidak sengaja memproses transaksi yang sama dua kali dan ingin membatalkan salah satunya.

Catatan

Pembatalan otorisasi tidak tersedia untuk setiap kartu di setiap negara. Lihat halaman ini kami untuk lebih jelasnya. Dalam situasi di mana pembatalan tidak didukung, refund dapat digunakan.

Membatalkan pembayaran yang telah diotorisasi

Buat request POST untuk /v3/payments/{payment_id}/cancel

Request - untuk /v3/payments/{payment_id}/cancel

/v3/payments/py-1402feb0-bb79-47ae-9d1e-e69394d3949c/cancel
{
  "payment_id": "py-1402feb0-bb79-47ae-9d1e-e69394d3949c",
  "business_id": "5f27a14a9bf05c73dd040bc8",
  "reference_id": "90392f42-d98a-49ef-a7f3-abcezas123",
  "payment_request_id": "pr-1102feb0-bb79-47ae-9d1e-e69394d3949c",
  "payment_token_id": "pt-cc3938dc-c2a5-43c4-89d7-7570793348c2",
  "customer_id": "cust-b98d6f63-d240-44ec-9bd5-aa42954c4f48",
  "type": "PAY",
  "country": "ID",
  "currency": "IDR",
  "request_amount": 1999.01,
  "capture_method": "AUTOMATIC",
  "channel_code": "CARDS",
  "channel_properties": {
    "mid_label": "mid_label_acquirer_1",
    "card_details": {
      "type": "CREDIT",
      "issuer": "BRI",
      "country": "ID",
      "network": "VISA",
      "fingerprint": "61f632879e9e27001a8165b9",
      "masked_card_number": "2222XXXXXXXX8888",
      "expiry_year": "2027",
      "expiry_month": "12",
      "cardholder_first_name": "John",
      "cardholder_last_name": "Doe",
      "cardholder_email": "example@xendit.co",
      "cardholder_phone_number": "+628000000000008"
    },
    "skip_three_ds": false,
    "card_on_file_type": "CUSTOMER_UNSCHEDULED",
    "failure_return_url": "https://xendit.co/failure",
    "success_return_url": "https://xendit.co/success",
  "status": "CANCELED",
  "payment_details": {
    "authorization_data": {
      "authorization_code": "A1B2C3",
      "cvn_verification_result": "M",
      "address_verification_result": "M",
      "retrieval_reference_number": "akjsdiuh132127y9sacsdjn",
      "network_response_code": "00",
      "network_response_code_descriptor": "testing",
      "network_transaction_id": "dahskjdhiquh341",
      "acquirer_merchant_id": "alskdnuoqh341",
      "reconciliation_id": "oiajsdo1823938yrh2"
    }
  },
  "metadata": {
    "metametadata": "metametametadata"
  },
  "created": "2029-12-31T23:59:59Z",
  "updated": "2029-12-31T23:59:59Z"
}