Instant Payment Notification (IPN)

This is a Webhook sent by Tanda to notify the API consumer about the payment status

Structure of the IPN

FieldDescription
trackingIdA unique identifier for tracking payments, generated on every successful request.
transactionIdA unique identifier for the transaction.
referenceA unique reference for the transaction that was generated by the API consumer.
statusThe status code of the payment.
messageA description of the status.
timestampThe timestamp of when the IPN was sent.
resultAdditional parameters from the service provider like transaction ref e.g.`ref

Sample IPN

{
  "trackingId": "108c7c01-ef49-46a3-8413-4a4241e959ec",
  "transactionId": "M95VBZRTM7A",
  "reference": "XNDEERI1",
  "status": "S000000",
  "message": "Successfully processed",
  "timestamp": "2024-06-12T13:30:29.258Z",
  "result": {
    "ref": "SFC99M93DD"
  }
}

Status Codes

StatusDescription
S000000Successful and fulfilled
P202000Request has been received and is currently being processed.
E400000Bad request
E401000Unauthorized
E403000Access denied
E404000Not found
E409000Duplicate resource found
E422005Request failed. Product not found
E422006Request failed. Insufficient Wallet balance
E422022Payment Request Validation Failed
E500000Internal Server Error
E501000Not implemented
E503000Service unavailable. Product / service is disable or unavailable