Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info
titleDeprecated Notifications
For documentation on the old deprecated webhook notifications click here.

Field Reference

(M) indicates fields that are mandatory in the request body. (m) Indicates fields that are mandatory only if the parent object is not empty.

FieldDescription
totalPayable (M)The amount to be paid by the customer
amountPaidThe exact amount paid by the customer

paymentStatus

Payment Status. Should always be `PAID` for reserved accounts. 

settlementAmountThe amount settled to the merchant. This is the amount paid minus the merchants' fee. 

paymentDescription

Defaults to the account name

transactionHash

Hash calculated and sent by Monnify with each notification request. Merchant is expected to calculate the Hash using the request body. If the hash values don’t match, please do not honor the notification request. 

currencyCode (M)The currency of the transaction being initialized. "NGN"
paymentMethodThe method used by the customer to process the transaction `ACCOUNT_TRANSFER` of `CARD`
productThe object containing information specific to the product being used.
product.typeThe monnify product in use for this payment e.g. Web_SDK, Reserved_Account, Invoice, etc.
product.referenceThe unique reference applicable to the product e.g. Account_Reference, Invoice Reference, payment reference, etc.
cardDetailsThe object containing information specific to the card used for payment. Will only be populated if the payment method was a card. else it will be null
cardDetails.cardTypeCard type (VISA, MASTER, VERVE)
cardDetails.authorizationCodeTransaction authorization code
cardDetails.last4Last 4 digits of the card
cardDetails.expMonthExpiry month of the card following DATE convention i.e. January is 00 and December is 11.
cardDetails.expYearExpiry year of the card in YYYY format
cardDetails.binFirst 6 digits of the card
cardDetails.reusableBoolean to specify if the authorizationCode is reusable
accountDetailsThe object containing information specific to the sender's bank information. Will only be populated if the payment method was ACCOUNT_TRANSFER. else it will be null
accountDetails.accountNumberSource account number for that transaction. This is the account number the customer transferred from during payment.
accountDetails.accountNameSource account name for that transaction. This is the account name of the account the customer transferred from during payment.
accountDetails.bankCodeBank code of the source bank where the customer transferred from. 
accountPaymentsAn array of accountDetails objects. Useful when multiple transfers were made for one transaction.
customerThe object containing the customer information
customer.customerNameFull name of the customer
customer.customerEmailThe email address of the customer

Filter by label (Content by label)
showLabelsfalse
showSpacefalse
cqllabel in ( "get-transaction-status" , "dynamic-accounts" , "invoicing" , "customer-reserved-accounts" )

...