Chargeback

Sebelum Anda mulai

Permintaan API Anda diautentikasi menggunakan token akses. Setiap permintaan yang tidak menyertakan token akses yang valid akan mengembalikan kesalahan. Pelajari lebih lanjut di Autentikasi.

Base URL

• UAT: https://transactions.transactional.uat.unico.app/api/public/v1
• Production: https://transactions.transactional.unico.app/api/public/v1

Minta peninjauan chargeback

POST /credit/transactions/{transaction_id}/chargeback — meminta peninjauan chargeback untuk transaksi yang ditentukan.

Header

Header	Nilai
Authorization	Bearer {token} — token akses yang valid.

Body

{
  "datetime": "2023-01-05T03:00:00.000Z",
  "requestor": { "key": "cpf", "value": "USER_CPF" },
  "name": "USER_NAME",
  "reason": "REQUEST_REASON",
  "observation": "GENERAL_OBSERVATIONS",
  "documents": [
    { "label": "FILE_NAME", "data": "JVBERi0xLjQKMSAwI==" }
  ]
}

Bidang	Tipe	Wajib	Deskripsi
datetime	string	ya	Tanggal dan waktu permintaan chargeback, format ISO 8601.
requestor	object	ya	Informasi pemohon.
requestor.key	string	ya	Jenis kunci identifikasi untuk pemohon (mis. cpf).
requestor.value	string	ya	Nilai kunci identifikasi untuk pemohon.
name	string	ya	Nama pemohon.
reason	string	ya	Alasan untuk permintaan chargeback.
observation	string	tidak	Observasi umum tentang permintaan.
documents	array	tidak	Dokumen terkait chargeback. Hingga 3 item, masing-masing dikodekan Base64 — hanya PDF.
documents[].label	string	ya (per item)	Nama atau deskripsi file.
documents[].data	string	ya (per item)	File PDF yang dikodekan Base64.

200 OK

{
  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0"
}

Bidang	Deskripsi
id	ID chargeback yang dihasilkan.

Untuk respons kesalahan, lihat Kesalahan — Pembuatan Transaksi.

Dapatkan status peninjauan chargeback

GET /credit/transactions/{transaction_id}/chargeback/{chargeback_id} — memeriksa status dari chargeback tertentu.

Header

Header	Nilai
Authorization	Bearer {token} — token akses yang valid.

200 OK

{
  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0",
  "status": "waiting"
}

Bidang	Deskripsi
id	ID chargeback.
status	Status terkini dari chargeback.

Lihat Enumerasi — Hasil Chargeback untuk semua kemungkinan status. Untuk mengoptimalkan performa, implementasikan Webhook alih-alih melakukan polling pada endpoint ini.