Are you looking for test card numbers?

Would you like to contact support?

Payment-method icon

African e-wallets and online banking Component

Add African e-wallets and online banking to an existing Components integration.

On this page, you can find additional configuration for adding African e-wallets and online banking to your Components integration.

Before you begin

This page assumes you've already:

When offering this payment method, note that African shoppers expect to see the email and phone number of your business on the payment form. Shoppers will use your contact information in case they need to refund or cancel their payment.

API reference

Select which endpoint you're integrating:

This is the default with Components v5.0.0 or later.
Parameter name Required Description
countryCode -white_check_mark- The country's two-letter country code. For example, KE.
reference -white_check_mark- For Cellulant, the value must be between 3 to 15 characters. Some MNOs restrict using longer values. If the reference is longer than 15 characters, it will be removed but the payment is not rejected.
shopperEmail The shopper's email address.
shopperName The shopper's first name and last name.
telephoneNumber The shopper's telephone number.
If you already have the shopper's name, email, and phone number, you can provide them in the /sessions request to improve the shopper experience. We pass this information to Cellulant so your shoppers won't have to fill these in later when they're redirected to the payment form.
curl https://checkout-test.adyen.com/v68/sessions \
-H "x-API-key: YOUR_X-API-KEY" \
-H "content-type: application/json" \
-d '{
  "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
  "reference": "YOUR_ORDER_REFERENCE",
  "amount": {
    "currency": "KES",
    "value": 1000
  },
  "countryCode": "KE",
  "telephoneNumber": "+254712123456",
  "shopperEmail": "shopper@example.com",
  "shopperName": {
    "firstName": "Simon",
    "lastName": "Hopper"
  },
  "returnUrl": "https://your-company.com/checkout?shopperOrder=12xy.."
}'
Client client = new Client("Your X-API-KEY", Environment.TEST);
Checkout checkout = new Checkout(client);

CreateCheckoutSessionRequest sessionRequest = new CreateCheckoutSessionRequest();
sessionRequest.setMerchantAccount("YOUR_MERCHANT_ACCOUNT");
sessionRequest.setReference("YOUR_ORDER_REFERENCE");

Amount amount = new Amount();
amount.setCurrency("KES}");
amount.setValue(1000L);
sessionRequest.setAmount(amount);

sessionRequest.setCountryCode("KE");
sessionRequest.setTelephoneNumber("+254712123456");
sessionRequest.setShopperEmail("shopper@example.com");

Name shopperName = new Name();
shopperName.setFirstName("Simon");
shopperName.setLastName("Hopper");
sessionRequest.setShopperName(shopperName);

sessionRequest.returnUrl("https://your-company.com/checkout?shopperOrder=12xy..");

CreateCheckoutSessionResponse sessionResponse = checkout.sessions(sessionRequest);
var checkoutSessionRequest = new CreateCheckoutSessionRequest
{
    MerchantAccount = "YOUR_MERCHANT_ACCOUNT",
    Reference = "YOUR_ORDER_REFERENCE",
    Amount = {
    Currency = "KES",
    Value = 1000
    },
    CountryCode = "KE",
    TelephoneNumber = "+254712123456",
    ShopperEmail = "shopper@example.com",
    ShopperName = {
    FirstName = "Simon",
    LastName = "Hopper"
    },
    ReturnUrl = "https://your-company.com/checkout?shopperOrder=12xy.."
};
var client = new Client("YOUR_X-API-KEY", Model.Enum.Environment.Test);
var checkout = new Checkout(client);
var createCheckoutSessionResponse = checkout.Sessions(checkoutSessionRequest);

Component configuration

Step 1: Create a DOM element

Create a DOM element on your checkout page, placing it where you want the payment method form to be rendered:

 <div id="cellulant-container"></div>

Step 2: Create an instance of the Component

Use the create method of your AdyenCheckout instance, in this case checkout, to create the Component:

const cellulantComponent = checkout.create('cellulant').mount('#cellulant-container');

Test and go live

Make a test payment then follow Cellulant's payment simulation instructions. Use the test credentials provided by Cellulant.

Then check the status of the test payment in your test Customer Area > Transactions > Payments.

Before you can accept live payments, you need to submit a request for Cellulant in your live Customer Area.

See also