LogoLogo
Document ValidationsPayment Methods
  • Welcome to LimePay API Docs
  • Getting Started with Lime-Pay
  • API Documentation
    • Deposits API
      • Technical and Security Aspects
        • Calculating the Signature
      • Endpoints
        • Deposit Creation Endpoint
          • Notifications
        • Deposit Status Endpoint
        • Payment Methods Endpoint
        • Currency Exchange Endpoint
        • Refund Creation Endpoint
          • Notifications
        • Refund Status Endpoint
      • Payment Methods
        • 🌍Africa
          • 🇧🇯Benin
          • 🇧🇼Botswana
          • 🇨🇲Cameroon
          • 🇨🇬Congo Brazzaville
          • 🇨🇩Congo DRC
          • 🇪🇬Egypt
          • 🇬🇦Gabon
          • 🇬🇭Ghana
          • 🇨🇮Ivory coast
          • 🇰🇪Kenya
          • 🇲🇼Malawi
          • 🇲🇱Mali
          • 🇳🇬Nigeria
          • 🇷🇼Rwanda
          • 🇿🇦South Africa
          • 🇹🇿Tanzania
          • 🇹🇬Togo
          • 🇺🇬Uganda
          • 🇿🇲Zambia
        • 🌏Asia
          • 🇧🇩Bangladesh
          • 🇨🇳China
          • 🇭🇰Hong Kong
          • 🇮🇳India
          • 🇮🇩Indonesia
          • 🇯🇵Japan
          • 🇲🇾Malaysia
          • 🇵🇰Pakistan
          • 🇹🇭Thailand
          • 🇹🇷Turkey
          • 🇻🇳Vietnam
      • API Codes
    • Cashouts API
      • Technical and Security Aspects
        • Calculating the Payload-Signature
      • Endpoints
        • Cashout Creation Endpoint
          • Notifications
        • Cashout Status Endpoint
        • Cashout Update Status Endpoint
        • Cashout Cancellation Endpoint
        • Cashout Bank Codes
      • Countries Validations
        • 🌍African Countries
          • 🇧🇼Botswana
          • 🇨🇲Cameroon
          • 🇨🇬Congo Brazzaville
          • 🇨🇩Congo DRC
          • 🇪🇬Egypt
          • 🇬🇭Ghana
          • 🇰🇪Kenya
          • 🇲🇼Malawi
          • 🇳🇬Nigeria
          • 🇷🇼Rwanda
          • 🇿🇦South Africa
          • 🇿🇲Zambia
          • 🇬🇦Gabon
        • 🌏Asian Countries
          • 🇧🇩Bangladesh
          • 🇨🇳China
          • 🇮🇳India
          • 🇮🇩Indonesia
          • 🇯🇵Japan
          • 🇲🇾Malaysia
          • 🇹🇭Thailand
          • 🇹🇷Turkey
          • 🇻🇳Vietnam
          • 🇵🇰Pakistan
      • API Codes
    • Reconciliation API
      • Technical and Security Aspects
      • Endpoints
      • API Codes
  • Knowledge Base
    • Countries Specifications
Powered by GitBook
On this page
  • V3 Cashouts API Integration
  • Postman collection

Was this helpful?

  1. API Documentation

Cashouts API

Cashouts API v3 Introduction

Last updated 7 months ago

Was this helpful?

V3 Cashouts API Integration

Cashout Flow

Find below the description of a cashout flow using the Lime-Pay cashouts integration:

1 - Upon your customer's request, you submit a cashout request through the Cashout-Request API or through the Merchants panel (Transactions -> Withdrawals -> Request Cashout).

2 - Initial validations are performed by the API, such as:

  • Merchant account balance enough to cover the cashout

  • Merchant account Transaction/Daily/Monthly limits permit the cashout

  • Destination Bank Account details are correct.

  • Customer's details are correct. Eg. Document ID

3 - If the previous step is correct, the cashout is created and remains on PENDING status, otherwise, it's DECLINED. If Pending, it will be then sent to the bank for processing, when that happens, the status is set to DELIVERED.

4 - Once the transaction comes back from the bank, it can be either COMPLETED or REJECTED (by the bank).

There are some cases in which the bank could Confirm the Cashout and then Reject it because the benficiary's bank account was, for any reason, unable to receive the funds. This is a corner case but should be considered when integrating.

Postman collection

In order for you to start testing our Cashouts APIs right away, we have prepared a Postman Collection you can use to test and validate your integration along with the functionalities we offer

We provide you with test credentials to our test environment, but make sure sure you replace the vars apiKey, apiPassphrase and apiSignaturein the Pre-req. Scripts section of all the requests with your own

Collection Web View | Postman
Click here to download the Postman Collection.
API credentials for cashouts
Logo