Onboarding kartu kredit

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

Penting

Onboarding Kartu Kredit dapat dilakukan baik dengan meminta selfie dari pengguna akhir dan menyelesaikan pendaftaran lengkap, atau dengan menggunakan kembali capture biometrik dari proses yang dijalankan oleh produk platform Unico IDCloud lainnya:

• Untuk menggunakan kembali proses yang dihasilkan oleh produk IDCloud lain, berikan ID proses referensi pada additionalInfo.processID;
• Proses referensi yang digunakan harus telah diselesaikan tidak lebih dari 1 jam sebelumnya.

Validasi kartu kredit

POST /walletid/transaction — memvalidasi kartu kredit.

Header

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

Body

{
  "identity": { "key": "cpf", "value": "12345678900" },
  "orderNumber": "onboarding-98765",
  "company": "company-id",
  "redirectUrl": "https://yourapp.com/wallet/return",
  "card": {
    "binDigits": "12345678",
    "lastDigits": "1234",
    "expirationDate": "12/2028",
    "name": "John Doe"
  },
  "value": 5000.00
}

Bidang	Tipe	Wajib	Deskripsi
identity	object	ya	Informasi identitas pengguna.
identity.key	string	ya	Jenis kunci pengidentifikasi pengguna.
identity.value	string	ya	Nilai kunci pengidentifikasi pengguna.
orderNumber	string	ya	Nomor yang terasosiasi dengan onboarding. 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 URL Schema untuk aplikasi mobile native).
card	object	ya	Informasi 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 — pastikan benar untuk menghindari masalah pengkodean atau masalah persetujuan.
value	number	tidak	Nilai maksimum yang diamankan.
additionalInfo	object	tidak	Kirim objek ini dengan processID untuk menggunakan kembali capture biometrik dari produk platform Unico IDCloud lainnya.
additionalInfo.processID	string	ya (jika additionalInfo dikirim)	ID proses referensi dari platform IDCloud.

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, dan menggunakan kembali nilai dapat memicu kesalahan replicated transaction.

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

Bidang	Deskripsi
id	ID transaksi yang dibuat.
status	Status transaksi saat ini.
link	Tautan yang terkait dengan transaksi. Hanya dikembalikan jika additionalInfo.processID tidak diberikan.
token	Token yang ditandatangani untuk menginisialisasi Verifikasi Kartu Tidak Hadir web SDK. Hanya dikembalikan jika additionalInfo.processID tidak diberikan.

Periksa status validasi

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

Header

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

200 OK

{
  "status": "processing",
  "hasIdentityChanged": false
}

Bidang	Deskripsi
status	Status terkini dari transaksi.
hasIdentityChanged	Opsional. Apakah terjadi pertukaran identitas dalam transaksi.

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

Untuk respons kesalahan, lihat Kesalahan — Onboarding kartu kredit.