Transaksi pembayaran

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

Buat Transaksi

POST /credit/transaction — membuat transaksi baru.

bahaya

Untuk memastikan konversi yang lebih baik, buat transaksi hanya setelah menyelesaikan pra-autentikasi atau validasi apa pun yang dapat menyelesaikan operasi sebelum pengalaman Verifikasi Kartu Tidak Hadir.

bahaya

Bidang orderNumber harus diisi dengan nomor pesanan yang unik dari pembelian tersebut dalam sistem e-commerce — menggunakan ID transaksional yang berbeda adalah tidak tepat. Menggunakannya kembali dapat menyebabkan konversi rendah (nomor pesanan membantu pengguna akhir menyelesaikan alur) dan kesalahan API seperti replicated transaction jika nomor pesanan, CPF, BIN, dan 4 digit terakhir yang sama digunakan.

Header

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

Body

{
  "identity": { "key": "cpf", "value": "12345678900" },
  "orderNumber": "order-98765",
  "company": "company-id",
  "redirectUrl": "https://yourapp.com/checkout/return",
  "card": {
    "binDigits": "12345678",
    "lastDigits": "1234",
    "expirationDate": "12/2028",
    "name": "John Doe"
  },
  "value": 199.90,
  "mainContacts": [
    { "key": "phone", "value": "5543999999999" }
  ]
}

Bidang	Tipe	Wajib	Deskripsi
identity	object	ya	Data identifikasi pengguna.
identity.key	string	ya	Jenis kunci identifikasi pengguna. cpf direkomendasikan — tingkat konversi lebih tinggi.
identity.value	string	ya	Nilai kunci identifikasi pengguna, tanpa titik atau tanda hubung.
orderNumber	string	ya	Nomor pesanan yang terasosiasi dengan transaksi. Digunakan sebagai indeks di portal dan sebagai kunci asing (foreign key) antara sistem Anda dan Verifikasi Kartu Tidak Hadir.
company	string	ya	ID perusahaan yang bertanggung jawab atas transaksi, disediakan oleh Unico.
redirectUrl	string	tidak	URL untuk mengarahkan ulang pengguna setelah menyelesaikan transaksi (URL HTTPS untuk web, atau skema URL untuk aplikasi mobile native).
card	object	ya	Informasi tentang kartu yang digunakan dalam transaksi.
card.binDigits	string	ya	8 digit pertama dari kartu.
card.lastDigits	string	ya	4 digit terakhir dari kartu.
card.expirationDate	string	tidak	Tanggal kedaluwarsa kartu.
card.name	string	ya	Nama pemegang kartu. Kirim dengan benar, hindari masalah pengkodean — data ini digunakan dalam pengalaman pengguna dan komunikasi.
value	number	ya	Total nilai pembelian.
mainContacts	array	tidak	Daftar kontak utama (email dan/atau telepon) yang digunakan untuk memberi tahu pengguna, ketika Verifikasi Kartu Tidak Hadir bertanggung jawab atas notifikasi.
fallbackContacts	array	tidak	Daftar kontak cadangan, dipicu jika upaya notifikasi kontak utama gagal.

200 OK

{
  "id": "6ab1771e-dfab-4e47-8316-2452268e5481",
  "status": "processing",
  "link": "https://developers/regional-solutions/card-not-present-verification.unico.app/t/6ab1771e-dfab-4e47-8316-2452268e5481",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresAt": "2026-07-22T15:30:00Z"
}

Bidang	Deskripsi
id	ID transaksi yang dibuat.
status	Status transaksi saat ini.
link	Tautan yang terkait dengan transaksi.
token	Token yang ditandatangani berisi parameter yang diperlukan untuk menginisialisasi Verifikasi Kartu Tidak Hadir web SDK.
expiresAt	Tanggal dan waktu kedaluwarsa transaksi, ISO 8601 (UTC).

peringatan

Jika validasi menentukan bahwa capture biometrik tidak diperlukan, respons memiliki status yang berbeda dan tidak ada tautan capture yang dihasilkan:

{
    "id": "6ab1771e-dfab-4e47-8316-2452268e5481",
    "status": "fast-inconclusive"
}

Ini terjadi ketika menggunakan modul Pre atau Super Pre untuk Checkout, sesuai Feature.

Untuk respons kesalahan, lihat Kesalahan — Pembuatan Transaksi.

Dapatkan Status Transaksi

GET /credit/transactions/{transaction_id} — memeriksa status terkini dari transaksi tertentu.

Header

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

200 OK

{
  "status": "processing"
}

Bidang	Deskripsi
status	Status transaksi saat ini.

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

Untuk respons kesalahan, lihat Kesalahan — Mendapatkan status transaksi.

Dapatkan Kumpulan Bukti Transaksi

GET /credit/transactions/{transaction_id}/probative — mengambil kumpulan bukti dari transaksi tertentu.

peringatan

Kumpulan bukti hanya dapat dihasilkan untuk transaksi yang disetujui.

bahaya

Tautan yang dikembalikan untuk kumpulan bukti berlaku selama lima menit setelah diperoleh — jangan menyimpannya, gunakan untuk mengunduh kumpulan bukti segera.

Header

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

200 OK

{
  "link": "https://unico.io/probative.pdf"
}

Bidang	Deskripsi
link	URL dari file probative.

Untuk respons kesalahan, lihat Kesalahan — Pengambilan kumpulan bukti transaksi.

Kirim Ulang Notifikasi Transaksi

POST /credit/transactions/{transaction_id}/notify — mengirim ulang notifikasi melalui email dan/atau telepon untuk transaksi tertentu.

catatan

Anda juga dapat mengonfigurasi pengiriman ulang notifikasi melalui portal, tanpa mengimplementasikannya melalui API. Bicaralah dengan titik kontak proyek Anda untuk memahami kemungkinan-kemungkinannya.

Header

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

Body

{
  "phone": "NOTIFICATION_PHONE",
  "email": "NOTIFICATION_EMAIL"
}

Bidang	Tipe	Wajib	Deskripsi
phone	string	ya	Nomor telepon untuk mengirim notifikasi.
email	string	ya	Alamat email untuk mengirim notifikasi.

200 OK

{
  "id": "b50ee24c-71eb-4a5d-ade1-41c48b44c240",
  "link": "https://aces.so/example"
}

Bidang	Deskripsi
id	ID unik dari notifikasi yang dihasilkan.
link	Tautan yang dihasilkan untuk notifikasi.

Untuk respons kesalahan, lihat Kesalahan — Mengirim ulang notifikasi transaksi.