Monicredit Api
  • 😊Hello
  • How to use this documentation
  • Demo vs Live Environment
  • Authentication
    • Login
  • OnBoarding
    • OnBoard New Merchant
  • Collection
    • Getting Started
    • Accept Payment (Inline)
    • Accept Payment (Standard)
    • Verify Payment
    • Virtual Accounts
    • Revenue Head
    • Settlement Bank
  • Transactions
    • Get Transactions
    • Get Initiated Transaction Info
    • Verify Transaction
    • Verify Payment
    • Transaction Virtual Account
    • Settlement Transactions
    • Initiate Transaction
  • Commercial
    • Calculate Commercials
  • Settlement Bank
    • Create Settlement Bank
    • List Settlement Banks
    • Update Settlement Bank
  • Revenue Heads
    • Create Revenue Head
    • Update Revenue Head
    • List Revenue Heads
    • Get Single Revenue Head
    • Search Revenue Head
    • Delete Revenue Head
  • Reports
    • Settlement Bank Report
    • Revenue Head Report
    • Merchant Report
  • Settlement
    • Get Settlements
    • Get Single Settlement
  • Wallets
    • Create Wallet
    • Update Wallet
    • Get Wallet Transactions
    • Get Single Customer Wallet
    • Get Account Wallets
    • Get All Wallets
    • Create Virtual Account
  • Customer Wallet
    • Create Customer Wallet
    • Get Customer Wallets
    • Create Customer Virtual Account
    • Update Customer Wallet
  • Beneficiary
    • Add Beneficiary
    • Update Beneficiary
    • Search Beneficiary
  • Disbursement
    • Single Fund Transfer
    • Transaction Settlement
    • Bank List
    • Name Enquiry
Powered by GitBook
On this page
  1. Collection

Settlement Bank

At the end of the day, all transactions are gathered and routed to the settlement bank being the destination of all transactions according to the conflagrations set.

Create Settlement -

Endpoint : POST - {{baseUrl}}/v1/payment/settlement_bank

In this case, the request is to add a new settlement bank through the API.

Parameter
Required
Description

title

yes

string

account_no

yes

string

account_name

yes

string

bank_code

yes

string

bank_name

yes

string

display

yes

enum(yes,no)

settlement_email

yes

email

Example Request

curl -X POST \
  {{baseUrl}}/v1/payment/settlement_bank \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_BEARER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "testing",
    "account_no": "0000000",
    "account_name": "testing testing",
    "bank_code": "006",
    "bank_slug": "BNG",
    "bank_name": "required",
    "display": "YES",
    "settlement_email": "settlement@gmail.com"
  }'

Response

{
    "status": true,
    "message": "settlement_bank.created",
    "data": {}
}

Fetch

Overview

Endpoint: GET - {{baseUrl}}/v1/payment/settlement_bank

In this case, the request is to access/fetch all settlement banks through the API.

Parameter
Required
Description

search

no

string

settlement_bank_id

no

string

Example Request

//A code snippet of how to consume the API

curl -X GET \
  {{baseUrl}}/v1/payment/settlement_bank \
  -H "Authorization: Bearer YOUR_BEARER_TOKEN"

Response

{
    "status": true,
    "message": "settlement_bank.view",
    "data": {
        "current_page": 1,
        "data": [
            {
                "id": 1,
                "title": "test",
                "settle_bank": "Test",
                "merchant_id": "MC00000",
                "account_no": "000000000",
                "account_name": "Test Test",
                "bank_code": "GBN",
                "bank_slug": "BNG",
                "rev_status": "revhead",
                "created_at": "2022-04-23T15:00:10.000000Z",
                "updated_at": "2022-04-23T15:00:10.000000Z",
                "bank_name": "required",
                "display": "yes",
                "order_no": 0000,
                "settlement_email": test@test.ng
            }
        ],
        "first_page_url": "https://demo.backend.monicredit.com/api/v1/payment/settlement_bank?page=1",
        "from": 1,
        "last_page": 1,
        "last_page_url": "https://demo.backend.monicredit.com/api/v1/payment/settlement_bank?page=1",
        "links": [
            {
                "url": null,
                "label": "« Previous",
                "active": false
            },
            {
                "url": "https://demo.backend.monicredit.com/api/v1/payment/settlement_bank?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next »",
                "active": false
            }
        ],
        "next_page_url": null,
        "path": "https://demo.backend.monicredit.com/api/v1/payment/settlement_bank",
        "per_page": 50,
        "prev_page_url": null,
        "to": 1,
        "total": 1
    }
}

Update

Overview

Endpoint: PUT - {{baseUrl}}/v1/payment/settlement-bank/:settlement_id

In this case, the request is to update a settlement bank through the API.

Parameter
Required
Description

title

no

string

merchant_id

no

string

account_no

no

string

account_name

no

string

bank_code

no

string

bank_slug

no

string

bank_name

no

string

display

no

string

settlement_email

no

string

Example Request

//A code snippet of how to consume the API

curl -X PUT \
  {{baseUrl}}/v1/payment/settlement-bank/:settlement_id \
  -H "Authorization: Bearer YOUR_BEARER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "test",
    "merchant_id": "6545fdfdfJKDHHJ",
    "account_no": "000000",
    "account_name": "Test Test",
    "bank_code": "006",
    "bank_slug": "BNG",
    "bank_name": "required",
    "display": "yes",
    "settlement_email": "settle@gmail.com"
  }'

Response

{
    "status": true,
    "message": "settlement_bank.updated",
    "data": {}
}

PreviousRevenue HeadNextGet Transactions

Last updated 1 year ago