วิธีเข้าถึงและใช้งาน Adyen API

Adyen API ขับเคลื่อนการประมวลผลการชำระเงินสำหรับธุรกิจทั่วโลก ช่วยให้นักพัฒนาสามารถจัดการธุรกรรมผ่านช่องทางออนไลน์, มือถือ และการชำระเงินแบบตัวต่อตัว วิศวกรผสานรวม API นี้เพื่อรองรับวิธีการชำระเงินมากกว่า 250 วิธีในกว่า 150 สกุลเงิน ทำให้มั่นใจได้ถึงอัตราการอนุมัติที่สูงและการป้องกันการฉ้อโกงที่แข็งแกร่ง ในขณะที่คุณสร้างระบบการชำระเงินที่ปลอดภัย เครื่องมือที่ช่วยลดความซับซ้อนในการทดสอบจึงกลายเป็นสิ่งจำเป็น

บทความนี้จะนำเสนอการแนะนำทางเทคนิคเกี่ยวกับการเข้าถึงและการใช้งาน Adyen API โดยละเอียด โดยทั่วไปนักพัฒนาจะเริ่มต้นด้วยการตั้งค่าพื้นฐานและพัฒนาไปสู่คุณสมบัติขั้นสูง ดังนั้นคำแนะนำจะดำเนินการตามลำดับนั้น อันดับแรก ทำความเข้าใจพื้นฐาน จากนั้นจึงดำเนินการนำไปใช้ในทางปฏิบัติ

Adyen API คืออะไร?

Adyen API ทำหน้าที่เป็นอินเทอร์เฟซรวมสำหรับเกตเวย์การชำระเงิน ช่วยให้แอปพลิเคชันสามารถประมวลผลธุรกรรมได้อย่างปลอดภัย แพลตฟอร์มนี้เชื่อมต่อโดยตรงกับเครือข่ายบัตรและวิธีการชำระเงินในท้องถิ่น โดยไม่ต้องผ่านตัวกลาง การเชื่อมต่อโดยตรงนี้ช่วยเพิ่มประสิทธิภาพและลดต้นทุน

Adyen มี API หลายประเภท เช่น Checkout สำหรับการชำระเงินออนไลน์, Recurring สำหรับการสมัครสมาชิก, Payouts สำหรับการโอนเงิน และ In-Person Payments สำหรับเครื่องชำระเงิน ณ จุดขาย นอกจากนี้ Platforms APIs ยังรองรับโซลูชันตลาดกลาง ในขณะที่ BinLookup ช่วยในการคำนวณค่าธรรมเนียมและตรวจสอบ 3D Secure

วิศวกรเข้าถึงสิ่งเหล่านี้ผ่าน RESTful endpoints โดยคำขอจะอยู่ในรูปแบบ JSON ตัวอย่างเช่น Checkout API จัดการการเริ่มต้นการชำระเงิน ในขณะที่ Webhooks แจ้งระบบเกี่ยวกับการเปลี่ยนแปลงสถานะ Adyen รักษาความเข้ากันได้แบบย้อนหลังผ่านการกำหนดเวอร์ชัน โดยต่อท้ายส่วนต่อท้ายเช่น /v68 ไปยัง URL

นอกจากนี้ Adyen ยังมีไลบรารีไคลเอ็นต์ในภาษาต่างๆ เช่น Java, Node.js, Python และ .NET ซึ่งช่วยลดความซับซ้อนในการเรียกใช้ นักพัฒนาติดตั้งสิ่งเหล่านี้ผ่านตัวจัดการแพ็กเกจ เช่น การใช้ npm สำหรับไลบรารี Node.js การตั้งค่านี้ช่วยเร่งการพัฒนาโดยการสรุปการโต้ตอบ HTTP ระดับต่ำ

อย่างไรก็ตาม Adyen API ต้องการการกำหนดค่าที่เหมาะสมจึงจะทำงานได้ หากไม่มีข้อมูลประจำตัว คำขอจะล้มเหลวพร้อมข้อผิดพลาดในการตรวจสอบสิทธิ์ ดังนั้น การตั้งค่าบัญชีจึงเป็นรากฐานสำคัญ

ทำไมต้องเลือก Adyen API สำหรับความต้องการด้านการชำระเงินของคุณ?

ธุรกิจเลือก Adyen API สำหรับความสามารถในการปรับขนาดและการเข้าถึงทั่วโลก ระบบประมวลผลธุรกรรมหลายพันล้านรายการต่อปีสำหรับบริษัทต่างๆ เช่น Uber และ eBay ฟีเจอร์ RevenueProtect ใช้แมชชีนเลิร์นนิงเพื่อตรวจจับการฉ้อโกง ลดการเรียกเก็บเงินคืนในขณะที่อนุมัติการชำระเงินที่ถูกต้องตามกฎหมาย

นอกจากนี้ Adyen ยังเพิ่มประสิทธิภาพรายได้ผ่านการกำหนดเส้นทางอัจฉริยะ โดยพยายามอนุมัติที่ล้มเหลวซ้ำโดยอัตโนมัติ ซึ่งเพิ่มอัตราความสำเร็จได้ถึง 5% สำหรับตลาดกลาง MarketPay จัดการการแบ่งเงินระหว่างผู้ขาย โดยปฏิบัติตามกฎระเบียบ

เมื่อเทียบกับทางเลือกอื่นอย่าง Stripe หรือ PayPal นั้น Adyen มีความโดดเด่นในด้าน Unified Commerce ซึ่งรวมการชำระเงินออนไลน์และออฟไลน์ไว้ภายใต้สัญญาเดียว นักพัฒนาชื่นชอบเอกสารประกอบโดยละเอียดและ API Explorer ซึ่งช่วยให้พวกเขาทดสอบ endpoints ได้แบบโต้ตอบ

อย่างไรก็ตาม การผสานรวมต้องใช้ความเชี่ยวชาญทางเทคนิค การตั้งค่าที่เรียบง่ายใช้เวลาไม่กี่ชั่วโมง แต่กระบวนการที่กำหนดเองอาจใช้เวลาหลายวัน Apidog ช่วยปรับปรุงกระบวนการนี้โดยช่วยให้สามารถจำลองและทดสอบได้อย่างรวดเร็ว ทำให้มั่นใจในความน่าเชื่อถือ

ถัดไป กำหนดค่าสภาพแวดล้อมของคุณเพื่อเริ่มต้น

คุณจะตั้งค่าบัญชีทดสอบ Adyen ได้อย่างไร?

คุณสร้างบัญชีทดสอบเพื่อทดลองโดยไม่ใช้เงินจริง ไปที่ เว็บไซต์ Adyen และลงทะเบียนสำหรับบัญชีนักพัฒนา ระบุรายละเอียดธุรกิจ รวมถึงชื่อบริษัทและที่ตั้ง Adyen จะตรวจสอบใบสมัคร โดยทั่วไปจะอนุมัติภายในไม่กี่วัน

เมื่อได้รับการอนุมัติแล้ว ให้เข้าสู่ระบบ Customer Area ที่ ca-test.adyen.com ที่นี่ คุณจัดการบัญชีร้านค้าที่ลงท้ายด้วย -ECOM สำหรับอีคอมเมิร์ซ สภาพแวดล้อมการทดสอบจำลองธุรกรรม โดยใช้หมายเลขบัตรปลอมจากเอกสารของ Adyen

ตัวอย่างเช่น ใช้บัตร 4111 1111 1111 1111 พร้อม CVV 737 สำหรับการทดสอบ Visa เปิดใช้งานวิธีการชำระเงิน เช่น iDEAL หรือ Klarna ในแดชบอร์ด ขั้นตอนนี้ช่วยให้มั่นใจว่าการผสานรวมของคุณรองรับการตั้งค่าภูมิภาค

นอกจากนี้ ให้แยกความแตกต่างระหว่างสภาพแวดล้อมการทดสอบและสภาพแวดล้อมจริง URL สำหรับการทดสอบใช้ test.adyen.com ในขณะที่ URL สำหรับการใช้งานจริงจะมีคำนำหน้าเฉพาะ เช่น [random]-[Company] Adyen แนะนำให้เริ่มต้นในโหมดทดสอบเพื่อหลีกเลี่ยงค่าใช้จ่าย

หลังจากตั้งค่าแล้ว ให้ขอข้อมูลรับรองเพื่อตรวจสอบสิทธิ์คำขอ

วิธีรับข้อมูลรับรอง API และ Client Key?

คุณสร้างคีย์ API ใน Customer Area ภายใต้ Developers > API credentials เลือกข้อมูลรับรองระดับร้านค้า เช่น ws@Company.[YourCompanyAccount] สร้างคีย์ใหม่หากไม่มีอยู่

คีย์ API จะคล้ายกับ Aq42_... และให้สิทธิ์การเข้าถึง endpoints คัดลอกอย่างปลอดภัย เนื่องจาก Adyen จะไม่แสดงอีกครั้ง ถัดไป สร้าง Client Key ในหน้าเดียวกันสำหรับการตรวจสอบสิทธิ์ฝั่งไคลเอ็นต์ โดยมีคำนำหน้าเป็น test_ หรือ live_

เพิ่มแหล่งกำเนิดที่อนุญาต เช่น http://localhost:8080 เพื่อป้องกันปัญหา CORS บันทึกการเปลี่ยนแปลง คีย์เหล่านี้ช่วยให้สามารถเรียกใช้เซิร์ฟเวอร์และส่วนประกอบฟรอนต์เอนด์ เช่น Drop-in ได้

จัดเก็บคีย์ในตัวแปรสภาพแวดล้อมหรือไฟล์คอนฟิก ไม่ควรเก็บไว้ในที่เก็บโค้ด สำหรับแอป Java ให้แทรกผ่านไฟล์คุณสมบัติ วิธีปฏิบัตินี้ช่วยเพิ่มความปลอดภัย

เมื่อข้อมูลรับรองพร้อมแล้ว ให้สำรวจการตรวจสอบสิทธิ์

วิธีการตรวจสอบสิทธิ์สำหรับ Adyen API มีอะไรบ้าง?

Adyen ใช้คีย์ API สำหรับการตรวจสอบสิทธิ์พื้นฐาน รวมคีย์ในส่วนหัว X-API-Key สำหรับคำขอฝั่งเซิร์ฟเวอร์ ตัวอย่างเช่น:

curl -H "X-API-Key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://checkout-test.adyen.com/v68/paymentMethods

ฝั่งไคลเอ็นต์ใช้ Client Key เพื่อเริ่มต้นไลบรารีเช่น Adyen.Web สิ่งนี้จะแยกความกังวล ลดการเปิดเผยข้อมูล

Webhooks ต้องการการตรวจสอบ HMAC Adyen เซ็นชื่อการแจ้งเตือนด้วยคีย์ HMAC ซึ่งคุณยืนยันโดยใช้ไลบรารี หากลายเซ็นไม่ถูกต้องแสดงว่ามีการแก้ไข

นอกจากนี้ endpoints บางตัวยังรองรับโทเค็น Bearer สำหรับ OAuth แต่คีย์ API ก็เพียงพอสำหรับการผสานรวมส่วนใหญ่ ใช้ HTTPS เสมอเพื่อเข้ารหัสการส่งข้อมูล

การตรวจสอบสิทธิ์ที่กำหนดค่าไม่ถูกต้องนำไปสู่ข้อผิดพลาด 401 ดังนั้น ให้ทดสอบข้อมูลรับรองตั้งแต่เนิ่นๆ

ตอนนี้ ตรวจสอบ endpoints หลัก

สำรวจ Key Endpoints ใน Adyen API

Adyen API จัดระเบียบ endpoints ตามฟังก์ชัน Endpoint /paymentMethods ดึงวิธีการที่ใช้ได้ตามสถานที่และสกุลเงิน ส่ง POST พร้อม merchantAccount:

{
  "merchantAccount": "YOUR_MERCHANT_ACCOUNT"
}

การตอบกลับแสดงรายการวิธีการต่างๆ เช่น บัตรหรือ iDEAL

Endpoint /payments เริ่มต้นธุรกรรม ใส่ amount, paymentMethod และ 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"
}

การตอบกลับที่สำเร็จจะรวม resultCode เช่น Authorised

สำหรับรายละเอียด ใช้ /payments/details เพื่อส่งข้อมูลเพิ่มเติม เช่น ผลลัพธ์ 3DS

Recurring API endpoints เช่น /recurring จัดการข้อมูลประจำตัวที่จัดเก็บไว้ Payouts API จัดการการโอนเงิน

Apidog ช่วยลดความซับซ้อนในการสำรวจสิ่งเหล่านี้โดยการนำเข้า collections ช่วยให้ปรับแต่งพารามิเตอร์และตรวจสอบการตอบสนองได้

สำหรับการดำเนินการ ให้ทำตามขั้นตอนเหล่านี้

คำแนะนำทีละขั้นตอน: การผสานรวม Adyen API เข้ากับแอปพลิเคชันของคุณ

นักพัฒนาผสานรวม Adyen API โดยใช้ส่วนประกอบฝั่งเซิร์ฟเวอร์และฝั่งไคลเอ็นต์ เริ่มต้นด้วยเฟรมเวิร์กแบ็คเอนด์ เช่น Java Spring Boot

ขั้นแรก เพิ่มไลบรารี Adyen ใน build.gradle:

implementation 'com.adyen:adyen-java-api-library:31.3.0'

กำหนดค่าไคลเอ็นต์:

Config config = new Config();
config.setApiKey("YOUR_API_KEY");
config.setEnvironment(Environment.TEST);
Client client = new Client(config);
PaymentsApi paymentsApi = new PaymentsApi(client);

บนฟรอนต์เอนด์ ให้รวม 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">

ดึงวิธีการชำระเงิน:

async function getPaymentMethods() {
  const response = await fetch('/api/paymentMethods', { method: 'POST' });
  return await response.json();
}

เริ่มต้น Drop-in:

const configuration = {
  paymentMethodsResponse: await getPaymentMethods(),
  clientKey: "YOUR_CLIENT_KEY",
  locale: "en_US",
  environment: "test",
  onSubmit: (state, dropin) => {
    // จัดการการส่ง
  }
};
const checkout = await AdyenCheckout(configuration);
checkout.create('dropin').mount('#dropin-container');

สำหรับการชำระเงิน ให้สร้าง endpoint แบ็คเอนด์:

PaymentRequest paymentRequest = new PaymentRequest();
paymentRequest.merchantAccount("YOUR_MERCHANT_ACCOUNT");
paymentRequest.amount(new Amount().currency("EUR").value(1000L));
// ตั้งค่าฟิลด์อื่นๆ
PaymentResponse response = paymentsApi.payments(paymentRequest);

จัดการ 3D Secure โดยการเพิ่ม browserInfo และ origin หาก action.type เป็น redirect ให้เปลี่ยนเส้นทางผู้ใช้

สำหรับ webhooks ให้ตั้งค่า endpoint เพื่อรับ POSTs ตรวจสอบ HMAC:

HMACValidator hmacValidator = new HMACValidator();
if (hmacValidator.validateHMAC(notificationItem, "YOUR_HMAC_KEY")) {
  // ประมวลผลเหตุการณ์
}

เปิดใช้งานวิธีการเฉพาะในแดชบอร์ด สำหรับ iDEAL:

เพิ่มการเลือกผู้ออกใน paymentMethod

สำหรับ Klarna ให้รวม lineItems:

"lineItems": [
  {
    "description": "Item",
    "quantity": 1,
    "amountIncludingTax": 1000
  }
]

ทดสอบด้วยส่วนขยายบัตรของ Adyen หรือการป้อนข้อมูลด้วยตนเอง

การผสานรวมนี้รองรับกระบวนการพื้นฐาน ขยายสำหรับการสร้างโทเค็น: จัดเก็บรายละเอียดด้วย /payments โดยตั้งค่า storeDetails: true

การอนุมัติล่วงหน้าจะถูกเรียกเก็บภายหลังผ่าน /captures

Apidog ช่วยโดยการจำลองการตอบกลับ ทดสอบกรณีขอบเขต

วิธีใช้ Apidog สำหรับการทดสอบ Adyen API?

Apidog ปรับปรุงการทดสอบ Adyen API ดาวน์โหลดเวอร์ชันฟรีและนำเข้า Adyen collection

ตัวอย่างเช่น วาง cURL สำหรับ /adjustAuthorisation:

Apidog จะแยกวิเคราะห์ข้อมูลและเติมฟิลด์ ส่งเพื่อดูการตอบกลับ

ทดสอบกระบวนการ: อนุมัติ จากนั้นเรียกเก็บเงิน ใช้การยืนยันสำหรับรหัสสถานะ

Apidog จำลอง endpoints, จำลองการหน่วงเวลาหรือข้อผิดพลาด ผสานรวมกับ CI/CD สำหรับการทำงานอัตโนมัติ

สำหรับ Adyen ให้ตรวจสอบความปลอดภัยเช่น 3DS โดยการเชื่อมโยงคำขอ

นอกจากนี้ สร้างเอกสารจากข้อมูลจำเพาะ แบ่งปันกับทีม

เครื่องมือนี้ช่วยลดการทำงานด้วยตนเอง ตรวจจับปัญหาได้ตั้งแต่เนิ่นๆ

แนวทางปฏิบัติที่ดีที่สุดสำหรับการใช้ Adyen API

ใช้คีย์ Idempotency เพื่อป้องกันการทำซ้ำ: ตั้งค่า UUID ใน RequestOptions

ใช้กระบวนการเซสชันเพื่อความปลอดภัยฝั่งไคลเอ็นต์ สร้างเซสชันฝั่งเซิร์ฟเวอร์

ตรวจสอบประสิทธิภาพด้วย webhooks, บันทึกเหตุการณ์

ปฏิบัติตาม PCI DSS โดยหลีกเลี่ยงการจัดเก็บข้อมูลที่ละเอียดอ่อน

ปรับขนาดโดยการจัดกลุ่มการจ่ายเงิน

นอกจากนี้ อัปเดตไลบรารีเป็นประจำสำหรับฟีเจอร์ต่างๆ

ปัญหาทั่วไปและการแก้ไขปัญหา

401 Unauthorized: ตรวจสอบคีย์ API

Invalid HMAC: ตรวจสอบว่าคีย์ตรงกันหรือไม่

Refused payments: ใช้บัตรทดสอบอย่างถูกต้อง

CORS errors: เพิ่ม origins

ปรึกษาบันทึกใน Customer Area

คุณสมบัติขั้นสูง: 3D Secure, Webhooks และอื่นๆ

เปิดใช้งาน 3DS แบบไดนามิก: ตั้งค่า attemptAuthentication: always

Webhooks แจ้งเตือนแบบไม่พร้อมกัน—จัดการเหตุการณ์ AUTHORISATION

สำหรับแพลตฟอร์ม ใช้ /transfers

ผสานรวม BinLookup สำหรับค่าธรรมเนียม

Apidog ทดสอบสิ่งเหล่านี้ด้วยสถานการณ์ต่างๆ

สรุป

ตอนนี้คุณรู้วิธีเข้าถึงและใช้ Adyen API อย่างมีประสิทธิภาพแล้ว ตั้งแต่การตั้งค่าไปจนถึงการผสานรวมขั้นสูง คู่มือนี้จะช่วยให้นักพัฒนาพร้อมใช้งาน ทดลองในโหมดทดสอบ จากนั้นจึงเปิดใช้งานจริง เครื่องมืออย่าง Apidog ช่วยเร่งกระบวนการ