---
title: "Cashlib"
slug: "cashlib"
updated: 2025-02-19T15:39:10Z
published: 2025-02-19T15:39:10Z
canonical: "docs.apcopay.com/cashlib"
---

> ## 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.

# Cashlib

**Cashlib** is a prepaid payment method offering vouchers that can be purchased with cash at retail locations or online. Users can use the unique voucher code for secure and relatively anonymous online transactions without needing a bank account or credit card. Cashlib is versatile, commonly used for online gaming, entertainment, and e-commerce.

**Supported Transaction Types**

- [ ] Authorisation
- [ ] Capture
- [x] Purchase
- [ ] Refund
- [ ] Void
- [ ] Withdrawals

## Integrations Supported

**Deposit**

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

### Branding

Official Website: [https://www.cashlib.com](https://www.cashlib.com)

Official Logo:

![](https://res.cloudinary.com/apimatic/image/upload/v1644349586/61d5d2c7716b21689d42a5da/61d5d2c7716b21689d42a5da--cashlib.jpg)

Logo changes occur occasionally, and there are instances when we might not receive prior notification. It is advisable to verify the most recent logo directly from the PSP.

Currencies & Countries Supported

| Title | Description |
| --- | --- |
| **Currencies Supported** | AUD, CHF, CZK, EUR, GBP, NOK, PLN, SEK |

## Additional attributes to process Cashlib

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

| Description | Hosted Payment Page |
| --- | --- |
| **Force Transaction Routing** | "Routing":{ "ForcePayment":"CASHLIB" } |
| **Language** | "Language":"en" |
| **Customer Details*** | "FirstName": "John", "LastName": "Doe", "DateOfBirth": "1990-01-01", "IPAddress": "127.0.0.1", "City": "Valletta" |
| **Test Indicator** (required in Sandbox Environment only) | "isTest": true |

*While skipping this parameter is an option, we will need to set up your profile to include a user interface for collecting this information from the customer.

**Sample Deposit Request below**

```json
{
  "TransactionType": "PURC",
  "Amount": 10.00,
  "Currency": "EUR",
  "OrderReference": "MerchantOrder1",
  "Email": "apcotest@test.com",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "UniqueReference": "3a9f50f7-2deb-4dbf-a186-d58641s36665"
  "Client": {
    "Email": "johndoe@gmail.com",
    "clientAccount": "Apco Test",
    "FirstName": "Apco",
    "LastName": "test",
    "City": "Valletta",
    "IPAddress": "1.1.1.1",
    "DateOfBirth" : "1990-05-03"
  },
  "Routing": {
  "ForcePayment": "CASHLIB"
}
  "IsTest": true
}
```

**Test Credentials**

**Cashlib Voucher Code**

| Detail |  |
| --- | --- |
| Voucher Code | 4914911261062110 6082264272224492 |