---
title: "Orange Mobile (Liberia)"
slug: "orange-mobile-liberia"
updated: 2025-02-19T15:47:14Z
published: 2025-02-19T15:47:14Z
canonical: "docs.apcopay.com/orange-mobile-liberia"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apcopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Orange Mobile (Liberia)

![](https://cdn.document360.io/358ada76-9dff-4d31-80ba-dad90c84bfa9/Images/Documentation/orangemoney.png)

| **Name** | Deposit | Withdrawal |
| --- | --- | --- |
| Orange Mobile (Liberia) | ✅ | ✅ |

## Currencies & Countries Supported

| Title | Description |
| --- | --- |
| **Currencies Supported** | LRD, USD |
| **Countries Supported** | **Liberia** |

## Supported Transaction Types

- [ ] Authorisation
- [ ] Capture
- [x] Purchase
- [x] Withdrawal*
- [ ] Void

## Integrations Supported

For the Deposit flow:

- [x] Hosted Payment Page
- [ ] Direct Connect ( server-to-server)

For the Withdrawal flow:

- [ ] Hosted Payment Page
- [x] 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](https://apcopay.redoc.ly/#tag/Hosted-Payment-Page) to create a Hosted Payment Page, use the below mandatory attributes to process a deposit.

| Description | Hosted Payment Page | Notes |
| --- | --- | --- |
| **Force Transaction Routing** | “Routing”:{ "ForcePayment": "ORANGEMONEY” } |  |
| **Client Information** | "Client": { "MobileNo”:”0777777588” } | The mobile number of the customer intending to make a deposit. The customer must then follow the steps provided by Orange to complete the deposit. |
| **Test Indicator** (required in Sandbox Environment only) | "isTest”: true |  |

A sample request can be found below

```json
{
  "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](https://apcopay.redoc.ly/#operation/PaymentOperationAUTHPURC).

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

| Description | Hosted Payment Page | Notes |
| --- | --- | --- |
| **Force Transaction Routing** | “Routing”:{ "ForcePayment": "ORANGEMOBILE” } |  |
| **Payment Method Data** | "PaymentDestination": { "PaymentMethod": "AlternativePaymentMethods", "PaymentMethodData": { "Wallet": "0777777588" } }, | The number entered in the wallet should correspond to the mobile number of the end-customer who is intended to receive the payout. |
| **Test Indicator** (required in Sandbox Environment only) | "isTest”: true |  |

A sample request can be found here:

```json
{
  "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.