Skip to main content
WEBHOOK
/
webhooks
/
fingo
{
  "id": "evt_01j7b7a6r8h3x",
  "type": "transaction.created",
  "created": 1723717200,
  "data": {
    "id": "txn_01j7b6f9p5y9h",
    "merchantTransactionId": "mtx_123",
    "processor": "mpesa",
    "processorReference": "ODI31...",
    "status": "completed",
    "type": "charge",
    "paymentMethod": "mobile_money",
    "amount": 10000,
    "chargedAmount": 10000,
    "fees": 0,
    "currency": "KES",
    "narration": "Invoice #1234",
    "chargedPhone": "+254712345678",
    "description": "<string>",
    "message": "Payment completed",
    "debitOrCredit": "credit",
    "destination": "customer_wallet",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "reference": "<string>",
    "externalReference": "<string>",
    "invoiceId": "<string>",
    "payoutId": "<string>",
    "stage": "<string>",
    "metadata": {}
  }
}

Headers

​
X-Fingo-Signature
string
required
​
X-Fingo-Event-Id
string
required

Body

application/json
​
id
string
required
Example:

"evt_01j7b7a6r8h3x"

​
type
enum<string>
required
Available options:
transaction.created,
transaction.processing,
transaction.succeeded,
transaction.failed,
transaction.reversed,
payout.succeeded,
payout.failed,
balance.updated
​
created
integer
required
Example:

1723717200

​
data
object
required

Response

200

Return 2xx to acknowledge receipt within 10 seconds

⌘I