HomeGuidesAPI Reference
Guides

Checkout Integration

Overview

Checkout Integration allows merchants to accept payments using EdfaPay’s hosted payment page.

Instead of handling payment details directly, the customer is redirected to a secure EdfaPay checkout page where the payment is completed.

This approach simplifies integration while ensuring full security and compliance.


Integration Flow

1. Initiate Payment

Create a payment session from your backend.

2. Redirect Customer

Redirect the customer to the EdfaPay checkout page.

3. Get Result

Receive the final payment status via redirect or webhook.


How It Works

Payment Initiation

The process begins when your backend sends a request to EdfaPay to create a checkout session.

Once the request is successful, EdfaPay returns a payment URL.


Customer Redirection

After receiving the payment URL, redirect the customer to the hosted checkout page.

On this page:

The customer enters payment details

The payment is securely processed by EdfaPay

3D Secure authentication is handled automatically if required


Payment Result Handling

After the payment is completed:

The customer is redirected back to your system

A webhook notification is sent with the final status

To verify the transaction, you can also request the payment status.


Recurring Payments

Checkout also supports recurring payments for subscriptions or repeated billing scenarios.


🔗 API Reference


Webhook Integration

Webhooks are used to receive real-time updates about payment results.

Your backend should:

Listen for payment events

Update order status

Handle success or failure cases

👉 Refer to the Webhook section for configuration.


Key Characteristics

Hosted by EdfaPay

Payment UI and card handling are fully managed by EdfaPay.

Minimal Integration Effort

Only backend request and redirect are required.

Secure by Design

No sensitive card data passes through your system.

Built-in 3D Secure

Authentication is handled automatically during checkout.


Summary

Checkout integration is ideal when:

You want a fast and simple integration

You do not want to handle card data

You prefer EdfaPay to manage the payment experience

The flow is based on:

Initiating the payment

Redirecting the customer

Receiving the final result


💡

Checkout integration is the fastest way to start accepting payments with minimal development effort.