Skip to main content
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 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 cukup memberikan Dodo Payments Attestation of Compliance (AOC) kepada Adyen dan tidak memerlukan sertifikasi sendiri.

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:
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 ws_123456@Company.YourCompanyAccount.
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

merchant account Anda adalah identifier akun yang digunakan Adyen untuk memproses transaksi Anda. Customer Area menampilkannya di pemilih akun di bagian atas, 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; Anda tidak dapat menyalinnya lagi nanti. 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

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.
Keduanya tidak dapat diambil kembali setelah dibuat. Untuk mengganti HMAC key, buat key baru di pengaturan webhook di Adyen. Lalu buka Settings → BYOP, pilih Edit Configuration, edit koneksi Adyen, tempelkan key ke Webhook Signing Secret, dan pilih Save & continue.Untuk mengganti API key, buat key baru di bagian Developers → API credentials. Dashboard Dodo tidak memungkinkan Anda mengubah secret key yang telah disimpan.
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

Terakhir diubah pada 26 September 2026