API Adyen mendukung pemrosesan pembayaran untuk bisnis di seluruh dunia, memungkinkan pengembang menangani transaksi di seluruh saluran online, seluler, dan tatap muka. Para insinyur mengintegrasikan API ini untuk mendukung lebih dari 250 metode pembayaran dalam lebih dari 150 mata uang, memastikan tingkat otorisasi yang tinggi dan pencegahan penipuan yang kuat. Saat Anda membangun sistem pembayaran yang aman, alat yang menyederhanakan pengujian menjadi sangat penting.
Artikel ini menyediakan panduan teknis tentang cara mengakses dan menggunakan API Adyen. Pengembang sering memulai dengan pengaturan dasar dan beralih ke fitur-fitur canggih, sehingga panduan ini mengikuti perkembangan tersebut. Pertama, pahami dasar-dasarnya, lalu beralih ke implementasi praktis.
Apa Itu API Adyen?
API Adyen berfungsi sebagai antarmuka terpadu untuk gateway pembayaran, memungkinkan aplikasi memproses transaksi dengan aman. Platform ini terhubung langsung ke jaringan kartu dan metode pembayaran lokal, melewati perantara. Koneksi langsung ini meningkatkan efisiensi dan mengurangi biaya.
Adyen menawarkan beberapa kategori API, termasuk Checkout untuk pembayaran online, Recurring untuk langganan, Payouts untuk transfer dana, dan In-Person Payments untuk terminal titik penjualan. Selain itu, API Platform mendukung solusi marketplace, sementara BinLookup membantu perhitungan biaya dan pemeriksaan 3D Secure.
Insinyur mengakses ini melalui endpoint RESTful, dengan permintaan yang diformat dalam JSON. Misalnya, API Checkout menangani inisiasi pembayaran, sementara Webhook memberi tahu sistem tentang perubahan status. Adyen menjaga kompatibilitas mundur melalui versioning, menambahkan sufiks seperti /v68 ke URL.
Selain itu, Adyen menyediakan pustaka klien dalam bahasa seperti Java, Node.js, Python, dan .NET, menyederhanakan panggilan. Pengembang menginstal ini melalui manajer paket—misalnya, menggunakan npm untuk pustaka Node.js. Pengaturan ini mempercepat pengembangan dengan mengabstraksi interaksi HTTP tingkat rendah.
Namun, API Adyen memerlukan konfigurasi yang tepat agar berfungsi. Tanpa kredensial, permintaan akan gagal dengan kesalahan autentikasi. Oleh karena itu, pengaturan akun menjadi dasar.
Mengapa Memilih API Adyen untuk Kebutuhan Pembayaran Anda?
Bisnis memilih API Adyen karena skalabilitas dan jangkauan globalnya. Sistem ini memproses miliaran transaksi setiap tahun untuk perusahaan seperti Uber dan eBay. Fitur RevenueProtect-nya menggunakan pembelajaran mesin untuk mendeteksi penipuan, meminimalkan chargeback sambil menyetujui pembayaran yang sah.
Selain itu, Adyen mengoptimalkan pendapatan melalui perutean cerdas, mencoba kembali otorisasi yang gagal secara otomatis. Ini meningkatkan tingkat keberhasilan hingga 5%. Untuk marketplace, MarketPay menangani pembagian dana antar penjual, mematuhi peraturan.
Dibandingkan dengan alternatif seperti Stripe atau PayPal, Adyen unggul dalam unified commerce—menggabungkan pembayaran online dan offline dalam satu kontrak. Pengembang menghargai dokumentasi terperinci dan API Explorer, yang memungkinkan mereka menguji endpoint secara interaktif.
Meskipun demikian, integrasi menuntut keahlian teknis. Pengaturan sederhana membutuhkan waktu berjam-jam, tetapi alur kustom membutuhkan waktu berhari-hari. Apidog meningkatkan proses ini dengan memungkinkan mock dan pengujian cepat, memastikan keandalan.
Selanjutnya, konfigurasikan lingkungan Anda untuk memulai.
Bagaimana Cara Mengatur Akun Uji Adyen?
Anda membuat akun uji untuk bereksperimen tanpa dana sungguhan. Kunjungi situs web Adyen dan daftar untuk akun pengembang. Berikan detail bisnis, termasuk nama perusahaan dan lokasi. Adyen meninjau aplikasi, biasanya menyetujui dalam beberapa hari.
Setelah disetujui, masuk ke Customer Area di ca-test.adyen.com. Di sini, Anda mengelola akun merchant yang berakhiran -ECOM untuk e-commerce. Lingkungan uji mensimulasikan transaksi, menggunakan nomor kartu palsu dari dokumentasi Adyen.
Misalnya, gunakan kartu 4111 1111 1111 1111 dengan CVV 737 untuk pengujian Visa. Aktifkan metode pembayaran seperti iDEAL atau Klarna di dasbor. Langkah ini memastikan integrasi Anda mendukung preferensi regional.
Selain itu, bedakan lingkungan uji dari lingkungan langsung (live). URL uji menggunakan test.adyen.com, sementara yang langsung menyertakan awalan unik seperti [random]-[Company]. Adyen menyarankan untuk memulai dalam mode uji untuk menghindari biaya.
Setelah pengaturan, dapatkan kredensial untuk mengautentikasi permintaan.
Bagaimana Cara Mendapatkan Kredensial API dan Kunci Klien?
Anda membuat kunci API di Customer Area di bawah Developers > API credentials. Pilih kredensial tingkat merchant, seperti ws@Company.[YourCompanyAccount]. Buat kunci baru jika belum ada.
Kunci API menyerupai Aq42_... dan memberikan akses ke endpoint. Salin dengan aman, karena Adyen tidak akan menampilkannya lagi. Selanjutnya, buat Client Key di halaman yang sama untuk autentikasi sisi klien, dengan awalan test_ atau live_.
Tambahkan origin yang diizinkan, seperti http://localhost:8080, untuk mencegah masalah CORS. Simpan perubahan. Kunci ini memungkinkan panggilan sisi server dan komponen frontend seperti Drop-in.
Simpan kunci dalam variabel lingkungan atau file konfigurasi, jangan pernah di repositori kode. Untuk aplikasi Java, masukkan melalui file properti. Praktik ini meningkatkan keamanan.
Dengan kredensial siap, jelajahi autentikasi.
Apa Saja Metode Autentikasi untuk API Adyen?
Adyen menggunakan kunci API untuk autentikasi dasar. Sertakan kunci dalam header X-API-Key untuk permintaan sisi server. Contoh:
curl -H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
https://checkout-test.adyen.com/v68/paymentMethods
Sisi klien menggunakan Client Key untuk menginisialisasi pustaka seperti Adyen.Web. Ini memisahkan masalah, mengurangi eksposur.
Webhook memerlukan validasi HMAC. Adyen menandatangani notifikasi dengan kunci HMAC, yang Anda verifikasi menggunakan pustaka. Tanda tangan yang tidak valid menunjukkan adanya gangguan.
Selain itu, beberapa endpoint mendukung token Bearer untuk OAuth, tetapi kunci API sudah cukup untuk sebagian besar integrasi. Selalu gunakan HTTPS untuk mengenkripsi transmisi.
Autentikasi yang salah konfigurasi menyebabkan kesalahan 401. Oleh karena itu, uji kredensial sejak awal.
Sekarang, periksa endpoint inti.
Mengeksplorasi Endpoint Kunci dalam API Adyen
API Adyen mengorganisir endpoint berdasarkan fungsi. Endpoint /paymentMethods mengambil metode yang tersedia berdasarkan lokasi dan mata uang. Kirim POST dengan merchantAccount:
{
"merchantAccount": "YOUR_MERCHANT_ACCOUNT"
}
Respons mencantumkan metode seperti kartu atau iDEAL.
Endpoint /payments memulai transaksi. Sertakan amount, paymentMethod, dan reference:
{
"amount": {
"currency": "EUR",
"value": 1000
},
"reference": "YOUR_REFERENCE",
"paymentMethod": {
"type": "scheme",
"number": "4111111111111111",
"expiryMonth": "03",
"expiryYear": "2030",
"cvc": "737"
},
"merchantAccount": "YOUR_MERCHANT_ACCOUNT",
"returnUrl": "https://your-site.com/return"
}
Respons yang berhasil menyertakan resultCode seperti Authorised.
Untuk detail, gunakan /payments/details untuk mengirimkan data tambahan, seperti hasil 3DS.
Endpoint API Berulang (Recurring) seperti /recurring menangani kredensial yang tersimpan. API Pembayaran (Payouts) mengelola transfer dana.
Apidog menyederhanakan eksplorasi ini dengan mengimpor koleksi, memungkinkan penyesuaian parameter dan validasi respons.
Beralih ke implementasi, ikuti langkah-langkah ini.
Panduan Langkah demi Langkah: Mengintegrasikan API Adyen ke dalam Aplikasi Anda
Pengembang mengintegrasikan API Adyen menggunakan komponen sisi server dan sisi klien. Mulailah dengan kerangka kerja backend seperti Java Spring Boot.
Pertama, tambahkan pustaka Adyen. Di build.gradle:
implementation 'com.adyen:adyen-java-api-library:31.3.0'
Konfigurasi klien:
Config config = new Config();
config.setApiKey("YOUR_API_KEY");
config.setEnvironment(Environment.TEST);
Client client = new Client(config);
PaymentsApi paymentsApi = new PaymentsApi(client);
Di sisi frontend, sertakan Adyen.Web:
<script src="https://checkoutshopper-test.adyen.com/checkoutshopper/sdk/5.0.0/adyen.js"></script>
<link rel="stylesheet" href="https://checkoutshopper-test.adyen.com/checkoutshopper/sdk/5.0.0/adyen.css">
Ambil metode pembayaran:
async function getPaymentMethods() {
const response = await fetch('/api/paymentMethods', { method: 'POST' });
return await response.json();
}
Inisialisasi Drop-in:
const configuration = {
paymentMethodsResponse: await getPaymentMethods(),
clientKey: "YOUR_CLIENT_KEY",
locale: "en_US",
environment: "test",
onSubmit: (state, dropin) => {
// Handle submission
}
};
const checkout = await AdyenCheckout(configuration);
checkout.create('dropin').mount('#dropin-container');
Untuk pembayaran, buat endpoint backend:
PaymentRequest paymentRequest = new PaymentRequest();
paymentRequest.merchantAccount("YOUR_MERCHANT_ACCOUNT");
paymentRequest.amount(new Amount().currency("EUR").value(1000L));
// Set other fields
PaymentResponse response = paymentsApi.payments(paymentRequest);
Tangani 3D Secure dengan menambahkan browserInfo dan origin. Jika action.type adalah redirect, arahkan pengguna.
Untuk webhook, siapkan endpoint untuk menerima POST. Validasi HMAC:
HMACValidator hmacValidator = new HMACValidator();
if (hmacValidator.validateHMAC(notificationItem, "YOUR_HMAC_KEY")) {
// Process event
}
Aktifkan metode tertentu di dasbor. Untuk iDEAL:
Tambahkan pilihan penerbit di paymentMethod.
Untuk Klarna, sertakan lineItems:
"lineItems": [
{
"description": "Item",
"quantity": 1,
"amountIncludingTax": 1000
}
]
Uji dengan ekstensi kartu Adyen atau input manual.
Integrasi ini mendukung alur dasar. Perluas untuk tokenisasi: Simpan detail dengan /payments, atur storeDetails: true.
Pra-otorisasi akan ditangkap nanti melalui /captures.
Apidog membantu dengan membuat mock respons, menguji kasus-kasus ekstrem.
Bagaimana Cara Menggunakan Apidog untuk Menguji API Adyen?
Apidog menyederhanakan pengujian API Adyen. Unduh versi gratis dan impor koleksi Adyen.
Misalnya, tempel cURL untuk /adjustAuthorisation:
Apidog menguraikannya, mengisi kolom. Kirim untuk melihat respons.
Uji alur: Otorisasi, lalu tangkap (capture). Gunakan pernyataan untuk kode status.
Apidog membuat mock endpoint, mensimulasikan penundaan atau kesalahan. Integrasikan dengan CI/CD untuk eksekusi otomatis.
Untuk Adyen, validasi keamanan seperti 3DS dengan merangkai permintaan.
Selain itu, buat dokumen dari spesifikasi, bagikan dengan tim.
Alat ini mengurangi upaya manual, menangkap masalah sejak dini.
Praktik Terbaik dalam Menggunakan API Adyen
Terapkan kunci idempoten untuk mencegah duplikat: Atur UUID di RequestOptions.
Gunakan alur sesi untuk keamanan sisi klien, menghasilkan sesi sisi server.
Pantau kinerja dengan webhook, mencatat peristiwa.
Patuhi PCI DSS dengan menghindari penyimpanan data sensitif.
Skalakan dengan mem-batch pembayaran.
Selain itu, perbarui pustaka secara teratur untuk fitur-fitur baru.
Masalah Umum dan Pemecahan Masalah
401 Tidak Sah: Periksa kunci API.
HMAC Tidak Valid: Verifikasi kunci cocok.
Pembayaran Ditolak: Gunakan kartu uji dengan benar.
Kesalahan CORS: Tambahkan origin.
Konsultasi log di Customer Area.
Fitur Lanjutan: 3D Secure, Webhook, dan Lainnya
Aktifkan 3DS dinamis: Atur attemptAuthentication: always.
Webhook memberi tahu secara asinkron—tangani peristiwa AUTHORISATION.
Untuk platform, gunakan /transfers.
Integrasikan BinLookup untuk biaya.
Apidog menguji ini dengan skenario.
Kesimpulan
Anda sekarang tahu cara mengakses dan menggunakan API Adyen secara efektif. Dari pengaturan hingga integrasi lanjutan, panduan ini membekali para pengembang. Bereksperimen dalam mode uji, lalu go live. Alat seperti Apidog mempercepat proses.