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
  • Deposit Status
  • Request
  • Example request
  • Example response
  • Response fields
  • Parameter current_payer_verification
  • 🏦 Bank_Account (Object)
  • Status Flow
  • Hosted Checkout Status Flow
  • OneShot Checkout Status Flow
  • Status codes

Was this helpful?

  1. API Documentation
  2. Deposits API
  3. Endpoints

Deposit Status Endpoint

Retrieve the status of a previously created deposit

Deposit Status

GET https://api-stg.lime-pay.com/v3/deposits/{deposit_id}

This endpoint allows you to retrieve the status of a deposit request.

Path Parameters

Name
Type
Description

deposit_id*

integer

LimePay deposit_id. It is obtained when creating the deposit

Headers

Name
Type
Description

X-Date*

string

ISO8601 Datetime with Timezone: yyyy-MM-dd'T'HH:mm:ssZ

X-Login*

string

Merchant X-Login API Key

Authorization*

string

Authentication signature hash


{
    "user_id": "a78d40c0-9f7c-40f0-93c2-9df76547f319",
    "deposit_id": 301423824,
    "invoice_id": "388433169",
    "country": "TH",
    "currency": "THB",
    "usd_amount": 56.10,
    "local_amount": 2000.00,
    "bonus_amount": 1.50,
    "bonus_relative": true,
    "payment_method": "QRT",
    "payment_type": "VOUCHER",
    "status": "COMPLETED",
    "payer": {
        "document": "1234567890123",
        "document_type": "PASS",
        "email": "[email protected]",
        "first_name": "Test",
        "last_name": "Testing",
        "address": {
            "street": "This street",
            "city": "That City",
            "state": "MH",
            "zip_code": "110123"
         },
        "phone": "+661234567890"
    },
    "fee_amount": 2.78,
    "fee_currency": "USD",
    "refunded": false,
    "current_payer_verification": "NO_CURRENT_PAYER_DATA",
    "provider_external_reference": "741231231234",
    "completed_payment_method_code": "QRT"
}
{
    "code": 208,
    "description": "Resource not found",
    "type": "RESOURCE_NOT_FOUND"
}

Request

Example request

Regarding the Authorization value, since the body of the requests will be empty, you should use an empty ("") string or nothing as the jsonPayload field.

curl --location --request GET 'https://api-stg.lime-pay.com/v3/deposits/301423824' \
--header 'X-Login: xxxxxxx' \
--header 'X-Date: 2020-06-24T17:13:21Z' \
--header 'Authorization: LIMEPAY e339247fb57b10c053159cf87d3a88415f9be567beb46a93f6839d9fc45d2c8a' \
--data-raw ''

import java.io.*;
import okhttp3.*;

public class main {
  public static void main(String []args) throws IOException{
    OkHttpClient client = new OkHttpClient().newBuilder()
      .build();
    Request request = new Request.Builder()
      .url("https://api-stg.lime-pay.com/v3/deposits/301423824")
      .method("GET", null)
      .addHeader("X-Login", "xxxxxxx")
      .addHeader("X-Date", "2020-06-24T17:13:21Z")
      .addHeader("Authorization", "LIMEPAY e339247fb57b10c053159cf87d3a88415f9be567beb46a93f6839d9fc45d2c8a")
      .build();
    Response response = client.newCall(request).execute();
    System.out.println(response.body().string());
  }
}

using System;
using RestSharp;

namespace HelloWorldApplication {
    class HelloWorld {
        static void Main(string[] args) {
            var client = new RestClient("https://api-stg.lime-pay.com/v3/deposits/301423824");
            client.Timeout = -1;
            var request = new RestRequest(Method.GET);
            request.AddHeader("X-Login", "xxxxxxx");
            request.AddHeader("X-Date", "2020-06-24T17:13:21Z");
            request.AddHeader("Authorization", "LIMEPAY e339247fb57b10c053159cf87d3a88415f9be567beb46a93f6839d9fc45d2c8a");
            request.AddParameter("application/json", "",  ParameterType.RequestBody);
            IRestResponse response = client.Execute(request);
            Console.WriteLine(response.Content);
        }
    }
}

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api-stg.lime-pay.com/v3/deposits/301423824",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => array(
    "X-Login: xxxxxxxx",
    "X-Date: 2020-06-24T17:13:21Z",
    "Authorization: LIMEPAY e339247fb57b10c053159cf87d3a88415f9be567beb46a93f6839d9fc45d2c8a"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Example response


{
    "user_id": "a78d40c0-9f7c-40f0-93c2-9df76547f319",
    "deposit_id": 301423824,
    "invoice_id": "388433169",
    "country": "TH",
    "currency": "THB",
    "usd_amount": 56.10,
    "local_amount": 2000.00,
    "bonus_amount": 1.50,
    "bonus_relative": true,
    "payment_method": "QRT",
    "payment_type": "VOUCHER",
    "status": "COMPLETED",
    "payer": {
        "document": "1234567890123",
        "document_type": "PASS",
        "email": "[email protected]",
        "first_name": "Test",
        "last_name": "Testing",
        "address": {
            "street": "This street",
            "city": "That City",
            "state": "MH",
            "zip_code": "110123"
         },
        "phone": "+661234567890"
    },
    "fee_amount": 2.78,
    "fee_currency": "USD",
    "refunded": false,
    "current_payer_verification": "NO_CURRENT_PAYER_DATA",
    "provider_external_reference": "741231231234",
    "completed_payment_method_code": "QRT"
}
{
    "deposit_id": 301423817,
    "invoice_id": "postmanTest315819867",
    "country": "TH",
    "currency": "THB",
    "usd_amount": 56.10,
    "local_amount": 2000.00,
    "bonus_amount": 1.50,
    "bonus_relative": true,
    "payment_method": "QRT",
    "payment_type": "VOUCHER",
    "status": "PENDING",
    "payer": {
        "document": "1234567890123",
        "document_type": "PASS",
        "email": "[email protected]",
        "first_name": "Test",
        "last_name": "Testing",
        "phone": "+662234567890"
    },
    "fee_amount": 2.78,
    "fee_currency": "USD",
    "refunded": false,
    "current_payer_verification": "NO_CURRENT_PAYER_DATA"
}
{
    "deposit_id": 301423924,
    "invoice_id": "postmanTest323497269",
    "country": "TH",
    "currency": "THB",
    "usd_amount": 56.11,
    "local_amount": 2000.00,
    "bonus_amount": 1.50,
    "bonus_relative": true,
    "status": "CREATED",
    "payer": {
        "document": "1234567890123",
        "document_type": "PASS",
        "email": "[email protected]",
        "first_name": "Test",
        "last_name": "Testing",
        "phone": "+662234567890"
    },
    "fee_amount": 2.78,
    "fee_currency": "USD",
    "refunded": false,
    "current_payer_verification": "NO_CURRENT_PAYER_DATA"
}

Response fields

Field name
Format
Description

user_id

String

ID generated for the user on LIME-PAY end

deposit_id

Number

ID of the deposit on LIME-PAY end

invoice_id

String

ID of the deposit on the merchant end

country

String

currency

String

local_amount

Number

Amount in local currency

usd_amount

Number

Amount in USD

bonus_amount

Number

The amount specified as bonus in the request

bonus_relative

Boolean

Specifies if the bonus_amount is absolute or relative. It will be shown only if the bonus_amount is not null

payment_method

String

payment_type

String

status

String

payer[]

Object

Object containing information about the payer. Only the values you've sent or we've collected will be shown.

payer.document

String

Payer's document of identity

payer.document_type

String

Payer's type of their document of identity

payer.email

String

Payer's email

payer.first_name

String

Payer's first name

payer.last_name

String

Payer's last name

payer.address[]

Object

Object containing the address details about the payer. Only the values you've sent or we've collected will be shown.

payer.address.city

String

Payer's city

payer.address.state

String

Payer's state ISO code

payer.address.street

String

Payer's street

payer.address.zip_code

String

Payer's zip code

fee_amount

Number

Fee of the deposit in the currency of your balance. It will be shown only if the payment_method was sent by you or selected by the customer

fee_currency

String

Currency of your balance. It will be shown only if the payment_method was sent by you or selected by the customer

card_detail[]

Object

Details about the credit card of the payer. This object will be shown only in case of credit card deposits and if we have the information.

card_detail.card_holder

String

Name of the card holder used to pay

card_detail.brand

String

Brand of the card used to pay

card_detail.masked_card

String

Masked card number used to pay

card_detail.expiration

String

Expiration of the card used to pay in format YYYY-MM (2023-12)

card_detail.card_type

String

Type of card used: CREDIT/DEBIT

card_detail.transaction_result

String

The result message of the credit card transaction

refunded

Boolean

It shows if the deposit it was refunded or not.

current_payer_verification

String

bank_account.bank_code

String

bank_account.account_number

String

The account number from which the deposit was completed.

bank_account.account_holder

String

The account holder's name from which the deposit was completed

provider_external_reference

String

Alphanumeric code that uniquely identifies financial transactions on the local banking system

Parameter current_payer_verification

Through the parameter current_payer_verification you can check if the current payer is the same person who created the deposit. Below you can see the possible results for this parameter: Match --> The document of the person who paid is the same as the one of the person who created the payment. Unmatch --> The documents are different. No client document -> It is when there is no document of the person who proceed with the payment (Current payer). No current payer data -> It is when there is no document of the person who proceed with the payment (Current payer)

In order to make the experience more personalized, we may add more fields to this response's object in the future. Please develop your integration to be able to ignore new fields to avoid any issues.

If you are not sending all the payer details in the deposit request, make sure you store the details we collect and share with this endpoint so that in future attempts you can re-use them instead of having the payers to fill in the same details every time they deposit.

🏦 Bank_Account (Object)

The bank_account object provides details about the bank account from which the deposit was made. This field is currently available for Bank Transfer payments in Nigeria, and is intended to support identification and reconciliation of incoming transactions.

If the bank code is not available, a default code of 41800 will be returned.

{
  "user_id": "a78d40c0-9f7c-40f0-93c2-9df76547f319",
  "deposit_id": 301423824,
  "invoice_id": "388433169",
  "country": "NG",
  "currency": "NGN",
  "usd_amount": 20,
  "local_amount": 30000,
  "bonus_amount": 1.50,
  "bonus_relative": true,
  "payment_method": "TR",
  "payment_type": "BANK_TRANSFER",
  "status": "COMPLETED",
  "payer": {
    "document": "1234567890123",
    "document_type": "ID",
    "email": "[email protected]",
    "first_name": "John",
    "last_name": "DOe",
    "address": {
      "street": "This street",
      "city": "That City",
      "state": "LG",
      "zip_code": "110123"
    },
    "phone": "+2348123456789"
  },
  "fee_amount": 0.5,
  "fee_currency": "USD",
  "refunded": false,
  "current_payer_verification": "NO_CURRENT_PAYER_DATA",
  "provider_external_reference": "741231231234",
  "bank_account": {
    "bank_code": 305,
    "account_number": "0189230918",
    "account_holder": "John Doe"
  }
}

Status Flow

Hosted Checkout Status Flow

OneShot Checkout Status Flow

  1. The DECLINED status is not a status by itself. It means the transaction couldn't be created because of an error with the data, the customer or the merchant configuration. No transaction will change its status from DECLINED.

  2. COMPLETED and CANCELLED* are final status.

  3. *There are cases in which the users pays after the deposit expired, or paid an incorrect amount and the deposit gets expired. When that happens manual intervention is required to approve the deposit hence a deposit could change its status from EXPIRED or CANCELLED to COMPLETED.

  4. EARLY RELEASED will only be used if you specified it in the deposit request.

  5. FOR REVIEW is a transient status we use to specify that the deposit is under revision.

  6. If the user doesn't pays, the transaction will be marked as EXPIRED. After 7 days it will change to CANCELLED.

Status codes

Check all the possible status in the following page:

Last updated 1 month ago

Was this helpful?

You can trigger the check of the status of a deposit at any moment you consider pertinent. However, every time a deposit changes its status, we will send you a containing the ID of the deposit so that you can check its status back to retrieve the new deposit's status.

In the status endpoint, all the request have to be sent as GET, containing the .

specified on the deposit request or selected by the user on our checkout. It will be shown only if the user has selected a payment method

. It will be shown only if the user has selected a payment method

. It will be shown only if it is not null.

The of the bank from which the deposit was completed.

to see each Deposit Status meaning.

notification
API Codes
Payment method code
Cashout Bank Code
It shows if the current payer is the same person who creates the deposit
Hosted Checkout Status Flow Diagram
OneShot Status Flow Diagram
Type of the payment method
usual headers
Country ISO code
Local currency code
Click here
Status of the deposit