💱Fiat Deposit

The Lazerpay On-Ramp API allows users to fund their Lazerpay wallet via a bank transfer.

Introduction

The unavailability of an On-Ramp solution can pose some drawbacks for some users. This is so because there could be some level of difficulty for merchants who possess little or no stablecoin to fund their Lazerpay wallet.

The Lazerpay On-Ramp API provides a solution that gives these merchants the ability to fund their wallets by the means of a bank transfer.

Get On-Ramp rates

Before using this service, it's important that a merchant is aware of the Lazerpay crypto purchase rates. The below sample API request shows how to use the get rates API.

GET https://api.lazerpay.engineering/api/v1/bank/funding/rate

Query Parameters

Name	Type	Description
currency*	String	NGN

Headers

Name	Type	Description
Authorization*	String	Bearer YOUR_SECRET_KEY

200: OK

{
  "message": "Bank funding rate retrieved successfully",
  "data": {
    "id": "24c8fc10-788d-4e14-99b3-3a5521b2687b",
    "rate": 875,
    "currency": "NGN",
    "country": "Nigeria",
    "type": "bank_funding",
    "createdAt": "2022-11-02T19:26:12.432Z",
    "updatedAt": "2022-11-03T11:45:46.176Z"
  },
  "statusCode": 200,
  "status": "success"
}

// Sample response
{
  "message": "Bank funding rate retrieved successfully",
  "data": {
    "id": "24c8fc10-788d-4e14-99b3-3a5521b2687b",
    "rate": 875,
    "currency": "NGN",
    "country": "Nigeria",
    "type": "bank_funding",
    "createdAt": "2022-11-02T19:26:12.432Z",
    "updatedAt": "2022-11-03T11:45:46.176Z"
  },
  "statusCode": 200,
  "status": "success"
}

Get all available deposit bank account details

Before initiating a fiat deposit transaction, the merchant would need to see all the available bank accounts they can pay to.

GET https://api.lazerpay.engineering/api/v1/bank/funding/accounts

Headers

Name	Type	Description
Authorization*	String	Bearer YOUR_SECRET_KEY

200: OK

{
  "message": "Bank accounts retrieved successfully",
  "data": [
    {
      "id": "8cdf3057-7f05-4e58-9a4f-e9493d7b48d8",
      "accountName": "Lazerpay Inc",
      "accountNumber": "0110613067",
      "bankName": "Test Bank",
      "type": "current",
      "routingNumber": null,
      "address": null,
      "currency": "NGN",
      "country": "Nigeria",
      "isDefault": false,
      "isActive": true,
      "network": "testnet",
      "createdAt": "2022-11-03T12:52:36.438Z",
      "updatedAt": "2022-11-03T12:52:36.438Z"
    }
  ],
  "statusCode": 200,
  "status": "success"
}

// Somple response
{
  "message": "Bank accounts retrieved successfully",
  "data": [
    {
      "id": "8cdf3057-7f05-4e58-9a4f-e9493d7b48d8",
      "accountName": "Lazerpay Inc",
      "accountNumber": "0110613067",
      "bankName": "Test Bank",
      "type": "current",
      "routingNumber": null,
      "address": null,
      "currency": "NGN",
      "country": "Nigeria",
      "isDefault": false,
      "isActive": true,
      "network": "testnet",
      "createdAt": "2022-11-03T12:52:36.438Z",
      "updatedAt": "2022-11-03T12:52:36.438Z"
    }
  ],
  "statusCode": 200,
  "status": "success"
}

Initiate On-Ramp

The below API samples what initiating a fiat deposit would look like. This works by;

• providing a bank account ID taken from the above response

• Specifying a supported stablecoin you wish to fund

• Passing a reference that would be used to identify this transaction

• Passing the currency you're using to pay

• Then, the amount you plan to send

When carrying out the transaction with your bank app, you are required to pass in the reference in your note.

The Lazerpay On-Ramp service currently only supports local NGN transfers.

POST https://api.lazerpay.engineering/api/v1/bank/funding/initiate

Headers

Name	Type	Description
Authorization*	String	Bearer YOUR_SECRET_KEY

Request Body

Name	Type	Description
reference*	String	4dgTHsr
bank_account_id*	String	8cdf3057-7f05-4e58-9a4f-e9493d7b48d8
coin*	String	USDT
currency*	String	NGN
amount*	Number	1000000
metadata	Object	{ "note": "I paid this" }

200: OK

{
  "message": "Bank funding initiated successfully",
  "statusCode": 200,
  "status": "success"
}

// Sample response
{
  "message": "Bank funding initiated successfully",
  "statusCode": 200,
  "status": "success"
}