--- title: Onboarding kartu kredit description: Referensi REST API untuk memvalidasi kartu kredit dan memeriksa status validasi pada fitur Onboarding Kartu Kredit milik Verifikasi Kartu Tidak Hadir. canonical: https://developer.unico.io/id/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/credit-card-onboarding locale: id generated_by: markdown-export --- - [/id/](/id/) - Solusi Regional - [Verifikasi Kartu Tidak Hadir](/id/dual-api/developers/regional-solutions/card-not-present-verification) - [Integrasi](/id/dual-api/developers/regional-solutions/card-not-present-verification/integration/overview) - [API](/id/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis) - [Referensi API](/id/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference) - Onboarding kartu kredit **Di halaman ini# 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](/id/developers/regional-solutions/card-not-present-verification/integration/authentication). Base URL **UAT**: `https://transactions.transactional.uat.unico.app/api/public/v1` **Production**: `https://transactions.transactional.unico.app/api/public/v1` PentingOnboarding 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 HeaderNilai`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, "additionalInfo": { "externalUserID": "YOUR_EXTERNAL_USER_ID" }} ``` BidangTipeWajibDeskripsi`identity`objectyaInformasi identitas pengguna.`identity.key`stringyaJenis kunci pengidentifikasi pengguna.`identity.value`stringyaNilai kunci pengidentifikasi pengguna.`orderNumber`stringyaNomor yang terasosiasi dengan onboarding. Digunakan sebagai indeks di portal dan sebagai kunci asing (foreign key) antara sistem Anda dan Verifikasi Kartu Tidak Hadir.`company`stringyaID perusahaan yang bertanggung jawab atas transaksi, disediakan oleh Unico.`redirectUrl`stringtidakURL untuk mengarahkan ulang pengguna setelah menyelesaikan transaksi (URL HTTPS untuk web, atau URL Schema untuk aplikasi mobile native).`card`objectyaInformasi kartu yang digunakan dalam transaksi.`card.binDigits`stringya8 digit pertama dari kartu.`card.lastDigits`stringya4 digit terakhir dari kartu.`card.expirationDate`stringtidakTanggal kedaluwarsa kartu.`card.name`stringyaNama pemegang kartu — pastikan benar untuk menghindari masalah pengkodean atau masalah persetujuan.`value`numbertidakNilai maksimum yang diamankan.`additionalInfo`objecttidakKirim objek ini dengan `processID` untuk menggunakan kembali capture biometrik dari produk platform Unico IDCloud lainnya, dan/atau dengan `externalUserID` untuk mengaktifkan [Verifikasi Senyap](/id/developers/regional-solutions/card-not-present-verification/integration/silent-verification) untuk transaksi ini.`additionalInfo.processID`stringtidakID proses referensi dari platform IDCloud.`additionalInfo.externalUserID`stringtidakPengidentifikasi yang sama yang dikonfigurasi melalui `externalUserId` SDK saat mengumpulkan metadata perangkat. Hanya diperlukan untuk memicu validasi senyap — tanpanya, transaksi tetap dibuat secara normal tetapi selalu mengikuti alur visual standar. bahayaBidang `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..."} ``` BidangDeskripsi`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. catatanJika `additionalInfo.externalUserID` dikirim dan transaksi disetujui secara senyap, respons juga melewatkan tautan capture:``` { "id": "6ab1771e-dfab-4e47-8316-2452268e5481", "status": "approved"} ``` Lihat [Verifikasi Senyap](/id/developers/regional-solutions/card-not-present-verification/integration/silent-verification) untuk alur lengkap, termasuk pengaturan SDK dan persyaratan waktu. ### Periksa status validasi​ `GET /walletid/transactions/{transaction_id}` — memeriksa status terkini dari transaksi tertentu. Header HeaderNilai`Authorization``Bearer {token}` — token akses yang valid. 200 OK ``` { "status": "processing", "hasIdentityChanged": false} ``` BidangDeskripsi`status`Status terkini dari transaksi.`hasIdentityChanged`Opsional. Apakah terjadi pertukaran identitas dalam transaksi. Lihat [Enumerasi](/id/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated) untuk semua kemungkinan status. Untuk mengoptimalkan performa, implementasikan Webhook alih-alih melakukan polling pada endpoint ini. Untuk respons kesalahan, lihat [Kesalahan — Onboarding kartu kredit](/id/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#credit-card-onboarding).Terakhir diperbarui pada 8 Okt 2026**