FAQS

Find quick answers to the most common questions about using the EdfaPay platform, covering setup, integration, troubleshooting, and best practices. This section is designed to help merchants and partners resolve issues and understand features without needing direct support.

Frequently Asked Questions (FAQ)

What card number can I use to test payments?

You can use the following test card details when your account is in test mode:

Card Number: 5123 4500 0000 0008
Expiry: 01/39
CVV: 100

These details simulate transactions without using real payment methods.

Can I use my real (live) card when testing payments?

No, only test cards work in test mode. Live cards are not supported during testing. Once you're ready for live mode, contact us to update your account.

Is it possible to test Apple Pay while in test mode?

No, Apple Pay is only available in live mode on a compatible device (iPhone, Mac).

How can I integrate Apple Pay in S2S integration or using the SDK?

Have an active Apple Developer account and create an Apple Merchant ID.
Contact our technical team for the necessary certificates and configuration files.
We recommend scheduling a short setup session with us.

Can I use a callback URL hosted on localhost?

No, it must be publicly accessible over the internet.

Can I use HTTP instead of HTTPS for the callback URL?

No, HTTPS is required for secure communication.

Can I use the same order ID more than once?

No, each order_id must be unique.

How should I build my callback URL?

Create a public POST endpoint (form-data) to capture the full callback data and store it for reference. Then configure it through dashboard

Where should the callback URL be configured?

Go to EdfaPay Dashboard → Settings → Callback URL and update it there.

How do I show the payment result using the callback response?

Match the transaction_id from the callback with your order and display the status (SUCCESS, FAILED) on your confirmation page. Include the confirmation page URL as term_3ds_url when initiating payment.

How can I customize the payment page UI?

Use our S2S Payment API for full control over the design, branding, and user experience, keeping customers on your site.

How do I confirm a transaction is successful and the callback is from EdfaPay?

Use the Status API with the transaction_id from the callback to verify success and authenticity.

Which fields are mandatory when initiating a new payment?

action, edfa_merchant_id, order_id, order_amount, order_currency, order_description, req_token, payer_first_name, payer_last_name, payer_email, payer_phone, payer_ip, term_url_3ds, auth, recurring_init, hash.

Can payer_first_name and payer_last_name be in Arabic?

Yes, both can be in Arabic or English, max 32 characters each.

Can I use IPv6 for payer_ip?

No, only IPv4 is supported.

Do I need to change settings when switching from checkout redirection to embedded checkout?

Yes, the integration uses different S2S APIs and request structures.

If a WooCommerce merchant changes their domain, do they need to notify us?

No. They just need to log in to the dashboard and update the callback URL.

How do I get started with EdfaPay integration?

Receive sandbox credentials, test APIs or plugins, then request production credentials. Guides and Postman collections are available.

What’s the difference between Hosted Checkout and Embedded Checkout?

Hosted Checkout: Redirect to EdfaPay’s secure page.
Embedded Checkout: Payment fields on your site via S2S APIs.

Can I use the same API credentials for multiple domains?

No, credentials are domain-specific. Contact us to add more domains.

What currencies are supported?

SAR by default. Other currencies can be enabled upon merchant request, but all payouts will be settled in SAR.

Do I need to send the amount in integer or decimal format?

Use decimal format with two decimal places (e.g., 100.00).

Can I change the amount after creating the payment link?

No, you must create a new payment link.

How long do refunds take to reflect?

Usually 10–14 business days, depending on the method and bank.

Do I get a callback when a refund is processed?

Yes, if a callback URL is configured.

What is the difference between User and Supervisor roles?

User: View transactions, generate links, basic access.
Supervisor: Full access, manage users, change settings, view API credentials.

When will I receive my settlement?

Contact support for your settlement schedule.

Can I process international payments?

Yes, if enabled on your account and approved by your acquiring bank.

Is there a minimum transaction amount?

Yes. Transactions below 0.10 SAR are not allowed.

Is there a maximum transaction amount?

No fixed maximum from EdfaPay, but banks may have limits.

Can I export my transaction history?

Yes, via dashboard → Transactions → Export.

How can I find the reason for a declined transaction?

From the dashboard, click the Eye icon to view the payment receipt where you will find reason.
The rejection reason is also included in the callback response.
You can call the Status API where the response will also include reason.
If the reason is still unclear, contact us at [email protected].

How do I update my bank account details for settlements?

Contact support for the update process.

Do you support multiple stores under one account?

Yes, contact us to configure it.

How do I close my merchant account?

Email [email protected] from your registered merchant email. Ensure all settlements, refunds, and chargebacks are complete.

Can I add my developer or employee as a dashboard user?

Yes, go to Users → Add User in the dashboard. The new user will get an email invite.