Chargeback

Markdown

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

Laporkan chargeback

POST /credit/transactions/{transaction_id}/chargeback — melaporkan kepada Unico bahwa chargeback telah diterima untuk transaksi yang ditentukan.

Melaporkan bukan sanggahan

Endpoint ini hanya melaporkan chargeback. Endpoint ini tidak membuka analisis chargeback dan tidak memicu jaminan tanggung jawab. Agar Unico menganalisis chargeback, buka sanggahan untuk transaksi tersebut di portal.

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"
}

Bidang	Tipe	Wajib	Deskripsi
datetime	string	ya	Tanggal dan waktu chargeback diterima, 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 chargeback.
observation	string	tidak	Observasi umum tentang chargeback.

201 Created

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

Bidang	Deskripsi
id	ID chargeback.

Sebuah transaksi hanya memiliki satu chargeback. Melaporkan transaksi yang sudah memiliki chargeback akan mengembalikan 200 OK dengan id dari chargeback yang ada, tanpa mengubahnya.

Untuk respons kesalahan, lihat Kesalahan — Pembuatan Transaksi.

Dapatkan status 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.

Chargeback yang dilaporkan tetap berstatus waiting. Jika transaksi disanggah di portal, id yang sama menunjukkan progres dan hasil analisis. Lihat Enumerasi — Hasil Chargeback untuk semua kemungkinan status. Untuk mengoptimalkan performa, implementasikan Webhook alih-alih melakukan polling pada endpoint ini.