deema BNPL Integration Guide

⚙️ 1. Overview

Integrating deema BNPL allows your customers to pay later while you
receive payment instantly.
The process starts in the Sandbox environment for testing, then
moves to the Live environment once approved.

All merchants must complete setup and testing before accepting real
customer transactions.

🧰 2. Integration Channels

deema provides several integration options to suit your business setup
and technology stack.
Choose one of the following official integration channels to get
started:

• Start Your Integration
  Guide
• Magento
• WooCommerce
• Android SDK
• iOS SDK
• Flutter SDK
• React Native SDK
• Deema Widget
• API
  Reference

Each channel includes detailed documentation and examples to help your
developers integrate quickly and securely.

🧪 3. Sandbox env and Testing

Before going Live, every merchant must complete the Sandbox testing
phase to ensure their system can communicate with deema successfully.

Steps:

1. Access the Sandbox
   • Use the credentials shared after initial registration.
   • Log in to the Merchant
     Portal.
2. Perform the Required Tests
   • Complete one successful transaction in Sandbox.
   • Test order cancellation and refund operations through
     the portal.
   • Verify that your system receives Webhook notifications for
     each order update.
3. Validate Results
   • Make sure your system updates order status correctly based on
     deema notifications.
   • Ensure the customer flow (checkout → payment → success/failure
     page) is smooth.

🔔 4. Webhook Configuration

Webhooks allow deema to automatically notify your system when an order's
payment status changes.

Setup Process:

1. Log in to your Merchant Portal.

2. Open the Webhook section from the sidebar.

3. Click Create New Webhook +.

4. Fill in the following fields:

   • Webhook Name (for example, "My Store Orders")
   • Webhook URL (your system endpoint to receive updates)
   • Headers (Add a secret Key, Value pair for the Header)

5. Save the configuration.

Test the Webhook

• Confirm your system receives it correctly and returns 200 OK.

💳 5. Widget Implementation

The deema Widget provides the official payment experience
for your customers.

How to Implement:

1. Add the deema payment option to your checkout page.
2. When the customer selects deema, the widget securely shows to them
   deema payment options and the steps to proceed with their payments.
3. After completing the payment, the customer is redirected to your
   success or failure page automatically.
4. The widget ensures the checkout flow meets deema's compliance and
   user experience standards.

🧾 6. Integration Summary

Below is the complete overview of how the integration operates:

1. Customer chooses deema at checkout.
2. Your system initiates a checkout session and redirects the customer
   to deema.
3. The customer completes payment on deema's page.
4. The customer returns to your website (success or failure page).
5. deema sends an automatic Webhook notification to update your
   system.
6. You can view, cancel, or refund orders from your Merchant Portal as
   needed.

🚀 7. Go Live Checklist

Before requesting Live activation, confirm that you've completed all the following:

🌐 8. Go Live Activation Steps

Once testing is complete:

1. Switch your system configuration from Sandbox to Live.
2. Contact the deema Support Team to request Live activation.
3. Use your new Live credentials.
4. Perform one small Live test transaction.
5. Confirm that your Webhook receives Live payment updates. ⚠️
6. Start accepting real payments from customers.

📘 9. Key Resources

• Merchant Portal: Merchant Portal
• Webhook Settings Page: Webhook Settings
• Register with deema for a Partnership: Business Registration
• deema Partner App (IOS): Deema Partners App on
  iPhone
• deema Partner App (Android): Deema Partners App on
  Android