arrow-left Back to announcements
DATE:
AUTHOR:
Mono product team
Dashboard API

April Product Updates: New v2 Endpoints, and more

DATE:
AUTHOR: Mono product team

Product Highlights

Introducing the Mono API Version 2

We have upgraded our Mono Connect and DirectPay APIs to a new version and introduced new endpoints that complement the v2 of the Mono widget. This update also includes the addition of the Customers APIs, expanding the customer management capabilities within Mono's ecosystem and allowing you to offer more seamless account linking and payment experiences to your users. You can read our full launch article here.

Product Improvements

Mono Dashboard

Settlement Webhook Notification: Partners can now choose to set up settlement webhook notifications on the Mono dashboard, so they get notified when DirectPay settlements are processed successfully to their accounts.

How it works

  1. Navigate to the Settlement Settings section on your dashboard

  2. Click on "Choose app" under the Settlement webhook section

  3. Select an app with the preferred webhook address you’d like to receive settlement notifications

    Webhook Sample

    Here’s an example of the webhook response you’d receive.

    {
  "event": "direct_debit.settlement_successful",
  "data": {
    "id": "6623e680ab1c5838d861e0ff",
    "status": "settled",
    "message": "Successfully settled.",
    "date": "2024-04-20T23:00:00.000Z",
    "currency": "ngn",
    "amount_collected": 1000517000,
    "fee": 2142535,
    "amount_settled": 101374465,
    "amount_refunded": 0,
    "refund_fee": 0,
    "settlementAccount": {
      "accountName": "MONO",
      "accountNumber": "9000025707",
      "institution": {
        "name": "Providus Bank",
        "code": "101",
        "nibssCode": "000023"
      }
    }
  }
}

Financial institutions

  1. Fidelity Personal Banking Authentication Outage: We have resolved this issue and your users can now link their Fidelity internet banking accounts via the Mono Connect widget to securely share their financial data.

  2. Flutterwave Authentication Outage:This issue has been resolved and your users can now link their Flutterwave accounts to securely share their financial data with your business.

  3. Paystack Authentication Outage: This issue has been fixed and your users can now link their Paystack accounts via the Mono Connect widget to securely share their financial data with your business.

Mono API

  1. Added an optional institution object to the body request of our /Initiate-Account-Linking and /Payment-Initiation APIs. This enhancement enables you to direct your users to the login page of any financial institution upon opening the generated URL. The institution object contains the ID, AUTH_METHOD, and ACCOUNT_NUMBER fields. For implementation details with Mono Connect, check here and for DirectPay, visit here.

  2. Updated all the response data field for /BVN-Lookup from CAMELCASE to SNAKE_CASE to maintain consistency and data integrity across our APIs. Also released sandbox environment for when scope is BANK_ACCOUNTS.

  3. Released Fixed Recurring Mandate which allows you to set a fixed amount for both signed and e-mandates when creating or initiating mandate authorisation.

  4. Released /Mashup-Lookup-API API which enables you to verify both the NIN, BVN and date of birth of the user in one single API call for seamless KYC verification, for mono lookup. The request requires BVN, NIN, and DATE_OF_BIRTH fields, all mandatory for successful lookup

We're always available to help

Mono Slack Community

Join the discussion, ask questions, and suggest new features in our Slack community

Get support

Email us at support@mono.co

Powered by LaunchNotes