--- title: Transaksi pembayaran description: Referensi REST API untuk membuat transaksi pembayaran, memeriksa status, mengambil bukti, dan mengirim ulang notifikasi di Verifikasi Kartu Tidak Hadir. canonical: https://developer.unico.io/id/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/payment-transactions 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) - Transaksi pembayaran **Di halaman ini# 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](/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` ### Buat Transaksi​ `POST /credit/transaction` — membuat transaksi baru. bahayaUntuk 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. bahayaBidang `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 HeaderNilai`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" } ], "additionalInfo": { "externalUserID": "YOUR_EXTERNAL_USER_ID" }} ``` BidangTipeWajibDeskripsi`identity`objectyaData identifikasi pengguna.`identity.key`stringyaJenis kunci identifikasi pengguna. `cpf` direkomendasikan — tingkat konversi lebih tinggi.`identity.value`stringyaNilai kunci identifikasi pengguna, tanpa titik atau tanda hubung.`orderNumber`stringyaNomor 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`stringyaID perusahaan yang bertanggung jawab atas transaksi, disediakan oleh Unico.`redirectUrl`stringtidakURL untuk mengarahkan ulang pengguna setelah menyelesaikan transaksi (URL HTTPS untuk web, atau skema URL untuk aplikasi mobile native).`card`objectyaInformasi tentang 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. Kirim dengan benar, hindari masalah pengkodean — data ini digunakan dalam pengalaman pengguna dan komunikasi.`value`numberyaTotal nilai pembelian.`mainContacts`arraytidakDaftar kontak utama (email dan/atau telepon) yang digunakan untuk memberi tahu pengguna, ketika Verifikasi Kartu Tidak Hadir bertanggung jawab atas notifikasi.`fallbackContacts`arraytidakDaftar kontak cadangan, dipicu jika upaya notifikasi kontak utama gagal.`additionalInfo`objecttidakKirim objek ini dengan `externalUserID` untuk mengaktifkan [Verifikasi Senyap](/id/developers/regional-solutions/card-not-present-verification/integration/silent-verification) untuk transaksi ini.`additionalInfo.externalUserID`stringya (jika `additionalInfo` dikirim)Pengidentifikasi yang sama yang dikonfigurasi melalui `externalUserId` SDK saat mengumpulkan metadata perangkat. Wajib untuk memicu validasi diam-diam — tanpanya, transaksi tetap dibuat secara normal tetapi selalu mengikuti alur visual standar. 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"} ``` BidangDeskripsi`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). peringatanJika 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](/id/developers/regional-solutions/card-not-present-verification/about-idpay/feature). catatanJika `additionalInfo.externalUserID` dikirim dan transaksi disetujui secara diam-diam, respons juga tidak menyertakan 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. Untuk respons kesalahan, lihat [Kesalahan — Pembuatan Transaksi](/id/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#transaction-creation). ### Dapatkan Status Transaksi​ `GET /credit/transactions/{transaction_id}` — memeriksa status terkini dari transaksi tertentu. Header HeaderNilai`Authorization``Bearer {token}` — token akses yang valid. 200 OK ``` { "status": "processing"} ``` BidangDeskripsi`status`Status transaksi saat ini. 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 — Mendapatkan status transaksi](/id/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#get-transaction-status). ### Dapatkan Kumpulan Bukti Transaksi​ `GET /credit/transactions/{transaction_id}/probative` — mengambil kumpulan bukti dari transaksi tertentu. peringatanKumpulan bukti hanya dapat dihasilkan untuk transaksi yang **disetujui**. bahayaTautan yang dikembalikan untuk kumpulan bukti berlaku selama **lima menit** setelah diperoleh — jangan menyimpannya, gunakan untuk mengunduh kumpulan bukti segera. Header HeaderNilai`Authorization``Bearer {token}` — token akses yang valid. 200 OK ``` { "link": "https://unico.io/probative.pdf"} ``` BidangDeskripsi`link`URL dari file probative. Untuk respons kesalahan, lihat [Kesalahan — Pengambilan kumpulan bukti transaksi](/id/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#recovery-of-the-evidentiary-set-of-the-transaction). ### Kirim Ulang Notifikasi Transaksi​ `POST /credit/transactions/{transaction_id}/notify` — mengirim ulang notifikasi melalui email dan/atau telepon untuk transaksi tertentu. catatanAnda juga dapat mengonfigurasi pengiriman ulang notifikasi melalui portal, tanpa mengimplementasikannya melalui API. Bicaralah dengan titik kontak proyek Anda untuk memahami kemungkinan-kemungkinannya. Header HeaderNilai`Authorization``Bearer {token}` — token akses yang valid. Body ``` { "phone": "NOTIFICATION_PHONE", "email": "NOTIFICATION_EMAIL"} ``` BidangTipeWajibDeskripsi`phone`stringyaNomor telepon untuk mengirim notifikasi.`email`stringyaAlamat email untuk mengirim notifikasi. 200 OK ``` { "id": "b50ee24c-71eb-4a5d-ade1-41c48b44c240", "link": "https://aces.so/example"} ``` BidangDeskripsi`id`ID unik dari notifikasi yang dihasilkan.`link`Tautan yang dihasilkan untuk notifikasi. Untuk respons kesalahan, lihat [Kesalahan — Mengirim ulang notifikasi transaksi](/id/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#resending-the-transaction-notification).Terakhir diperbarui pada 8 Okt 2026**