Orange Mobile (Liberia)

Currencies & Countries Supported

Supported Transaction Types

• Authorisation

• Capture

• Purchase

• Withdrawal*

• Void

Integrations Supported

For the Deposit flow:

• Hosted Payment Page

• Direct Connect ( server-to-server)

For the Withdrawal flow:

• Hosted Payment Page

• Direct Connect ( server-to-server)

Additional attributes to process via Orange Mobile

You must include the following JSON Attributes to the payload. These attributes inform us to proceed with the redirection to the relevant payment method in order to finalize the payment process.

Deposit

Refer to our API Reference Document here to create a Hosted Payment Page, use the below mandatory attributes to process a deposit.

A sample request can be found below

{
  "TransactionType": "PURC",
  "Amount": "1.00",
  "Currency": "USD",
  "OrderReference": "Orange Money TEST",
  "UniqueReference": "4b8da4f0-d3b4-44ae-8019-8c66905ffad7",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "FailRedirectionURL": "https://yourURLhere.com/FailRedirect/",
  "Routing": {
    "ForcePayment": "ORANGEMONEY"
  },
  "Client": {
    "FirstName": "Apco",
    "LastName": "Test",
    "ClientAccount": "APCOPAY TEST",
    "Email": "johndoe@mail.com",
    "IPAddress": "127.0.0.1",
    "City": "Valletta",
    "MobileNo":"0777777588"
  },
  "IsTest": true
}

Withdrawals

Withdrawals are processed via Direct Connect. The API reference to request a payout can be found here.

Below are the mandatory attributes required to process a payout via Orange Mobile.

A sample request can be found here:

{
  "TransactionType": "ORIGINALCREDIT",
  "Amount": "1.00",
  "Currency": "USD",
  "OrderReference": "Orange Money test payout",
  "UniqueReference": "4b8da4f0-d3b4-44ae-8019-8c66905ffad7",
  "PaymentDestination": {
    "PaymentMethod": "AlternativePaymentMethods",
    "PaymentMethodData": {
      "Wallet": "0777777588"
    }
  },
  "Routing": {
    "ForcePayment": "ORANGEMONEY"
  },
  "Client": {
    "FirstName": "Joe",
    "LastName": "Bloggs",
    "Country": "MLT",
    "Street": "High Street",
    "City": "MagicCity",
    "Email": "apcotest@test.com",
    "IPAddress": "214.21.134.79"
  },
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "IsTest": true
}

Testing your integration

To test the integration, the merchant needs provides a test number, and test funds are allocated within a test environment. This setup allows the merchant to simulate and validate the entire transaction flow, including successful and failed transactions and payouts. The transactions are monitored, and any issues are resolved. Once testing is successful, the integration is approved for production.