Adyen - Koneksi & Akses API Kartu Mentah

Aktifkan akses data kartu mentah di Adyen, lalu kumpulkan API key, merchant account, dan HMAC key untuk menghubungkan Adyen ke Bring Your Own Processor (BYOP).

Panduan ini menyiapkan akun Adyen Anda untuk Bring Your Own Processor (BYOP): Anda meminta akses data kartu mentah dari Adyen, lalu mengumpulkan API key, merchant account, dan HMAC key yang diperlukan Dodo Payments. Jika memerlukan bantuan, hubungi kami.

​

Aktifkan Akses Data Kartu Mentah

Sebelum Dodo Payments dapat merutekan pembayaran melalui Adyen, akun Adyen Anda memerlukan akses ke data kartu mentah. Adyen hanya mengaktifkannya untuk konfigurasi yang mematuhi PCI DSS. Dodo Payments menangani data kartu mentah atas nama Anda dan mematuhi PCI DSS Level 1, sehingga Anda tidak memerlukan lingkungan data kartu sendiri. Adyen tetap meminta PCI DSS Self-Assessment Questionnaire (SAQ) atau Attestation of Compliance Anda sendiri yang mencantumkan Dodo Payments di Bagian 2f, bersama dengan Dodo Payments Attestation of Compliance (AOC).

Dodo Payments PCI DSS Attestation of Compliance (AOC)

Unduh AOC Dodo Payments terbaru dan kirimkan kepada dukungan Adyen untuk mengaktifkan akses data kartu mentah.

Untuk meminta akses data kartu mentah bagi merchant account Anda, hubungi dukungan Adyen dan lampirkan AOC.

​

Yang Anda Perlukan

Untuk menghubungkan Adyen di Settings → BYOP, Anda memerlukan tiga nilai dari Adyen Customer Area:

Nilai	Sumber
API key	Developers → API credentials
Merchant Account	Identifier merchant account Adyen Anda
HMAC key	Dibuat saat Anda menyiapkan webhook

Adyen memisahkan kredensial test (ca-test.adyen.com) dan live (ca-live.adyen.com). Buat kredensial di Customer Area yang sesuai dengan mode Dodo Payments yang sedang Anda konfigurasi.

​

Langkah 1: Buat API Key

Untuk membuat API key, Anda memerlukan peran Manage API credentials atau Merchant admin di Customer Area.

1. Open API Credentials

   Masuk ke Adyen Customer Area, pilih akun Company Anda, lalu buka Developers → API credentials.

2. Select Your Credential

   Pilih tab Payments, lalu pilih username kredensial Anda. Username tersebut terlihat seperti [e-mail].

3. Generate the Key

   Di bagian Server settings → Authentication, buka tab API key, lalu pilih Generate API key.

4. Copy It Immediately

   Pilih ikon salin dan simpan key dengan aman. Anda tidak dapat menyalinnya lagi setelah meninggalkan halaman. Lalu pilih Save changes. Key yang baru dibuat langsung aktif, sedangkan key sebelumnya tetap berfungsi selama 24 jam.

   Di Dodo Payments, tempelkan key ke kolom Secret Key.

​

Langkah 2: Temukan Merchant Account Anda

akun merchant Anda adalah pengidentifikasi akun yang digunakan Adyen untuk memproses transaksi Anda. Untuk menemukannya, buka Settings → Merchant accounts di Customer Area, misalnya YourCompany_ECOM.

Tempelkan identifier tersebut ke kolom Merchant Account di Dodo Payments. Setelah penyiapan selesai, merchant account disimpan dengan aman dan tidak dapat diubah.

​

Langkah 3: Siapkan Webhook dan HMAC Key

Saat Anda menyimpan koneksi Adyen, Dodo Payments membuat URL Webhook Endpoint. Tambahkan URL tersebut sebagai webhook di Adyen, lalu buat HMAC key. Anda memerlukan peran Merchant admin atau Merchant technical integrator.

1. Create a Webhook

   Di Customer Area, buka Developers → Webhooks, lalu pilih Create new webhook. Dalam daftar jenis webhook, pilih Add di samping Standard webhook.

2. Configure the Webhook

   • Masukkan Description.
   • Aktifkan toggle Enabled.
   • Di bagian Server configuration, tempelkan URL Webhook Endpoint yang dibuat Dodo Payments ke kolom URL. URL tersebut harus menggunakan HTTPS dan dapat diakses secara publik.
3. Generate the HMAC Key

   Di bagian Security, pada bagian HMAC Key, pilih Generate untuk membuat HMAC key baru. Salin key tersebut dan simpan dengan aman. Lalu pilih Save configuration.

4. Paste the HMAC Key into Dodo

   Di Settings → BYOP, tempelkan HMAC key ke kolom Webhook Signing Secret, lalu pilih Save & continue untuk menyelesaikan koneksi.

   Set up BYOP

   Ikuti alur penyiapan Bring Your Own Processor selengkapnya.

Sebelum Anda menyimpan HMAC key, koneksi Adyen ditampilkan sebagai Incomplete di bagian Edit Configuration pada Settings → BYOP. Setelah Anda menyimpannya, koneksi ditampilkan sebagai Connected.

​

Pertanyaan Umum

What is the HMAC key for?

Adyen menandatangani setiap webhook dengan tanda tangan HMAC, sehingga penerima dapat memverifikasi integritas dan asal notifikasi. Dodo Payments menggunakan HMAC key yang Anda berikan untuk memvalidasi webhook dari akun Adyen Anda.

I lost my API key or HMAC key, what now?

Anda tidak dapat menyalin API key lagi setelah meninggalkan halaman. Untuk mengganti HMAC key, buat yang baru di pengaturan webhook di Adyen. Lalu buka Settings → BYOP, pilih Edit Configuration, edit koneksi Adyen, tempelkan key tersebut ke Webhook Signing Secret, lalu pilih Save & continue.

Dasbor Dodo tidak memungkinkan Anda mengubah API key yang telah disimpan. Untuk menggantinya, buat API key baru di Developers → API credentials, lalu hubungi [e-mail] untuk memperbarui koneksi.

Do test and live use the same credentials?

Tidak. Buat kredensial di environment yang sesuai, test (ca-test.adyen.com) atau live (ca-live.adyen.com), lalu konfigurasikan kredensial tersebut dalam mode yang sesuai di Dodo Payments. Adyen juga memerlukan HMAC key baru saat Anda beralih dari test ke live.

​

Referensi

• Adyen: API credentials
• Adyen: Configure and manage webhooks