FIfincra

Initiate a mobile charge

Changed on

This API lets you charge your customer mobile phone

post/checkout/charges/

Request

Headers

x-business-idstring

Request body

amountinteger

The amount to charge the customer

referencestring

The unique transaction reference identifies the transaction on your application. If you do not provide one, a unique transaction reference would be generated for the transaction.This must be 8 letters.

currencystring

The currency in which the customer should be charged. Only NGN is available for now.

operatorstring

The mobile money operator. Make use of List available mobile money operators

type'mobile_money'

This payment type which can in this case is mobile money

phonestring

The customer's payAttitude account phone number. This is required if "type" is payattitude

descriptionstring

The description of the transaction

settlementDestination'' | 'wallet' | 'bank_account'

A settlement destination is the location where you want your payments to be settled. It could be a wallet or a bank account. The settlement destination is your Fincra wallet by default.

callbackUrlstring

The URL to redirect your customer when the transaction is complete.

webhookUrlstring

The URL to receive transaction notifications.

Response

200

statusboolean
messagestring

Example response

{
  "status": true,
  "message": "Charge created",
  "data": {
    "id": 280,
    "authorization": {
      "mode": "PIN"
    },
    "auth_model": "PIN",
    "amount": 150000,
    "currency": "NGN",
    "fee": 2000,
    "message": "Card PIN required",
    "status": "processing",
    "reference": "KPHHHHSS",
    "type": "card",
    "customer": {
      "name": "Fincra Developers",
      "email": "developers@fincra.com",
      "phoneNumber": "+2348142986562"
    },
    "settlementDestination": "wallet"
  }
}

Changes