Skip to main content
GET
Get a collection

Authorizations

Authorization
string
header
required

Your Jenzy API key: Authorization: Bearer jz_live_…

Path Parameters

id
string
required

The collection id (UUID).

Response

The collection.

id
string<uuid>
required

Collection id — your handle for polling and support.

status
enum<string>
required

settled means the money credited your balance. reversed means the provider then clawed the pay-in back — treat the collection.reversed event as authoritative; your balance catches up.

Available options:
settled,
reversed
Example:

"settled"

amount_mwk
string
required

The gross amount the sender sent — exact decimal string at 2 decimal places. Parse with a decimal library, never a float.

Example:

"1000.00"

fee
string
required

The transaction fee, as one combined figure — an exact decimal string. Always equal to amount_mwk minus amount_credited. Use POST /fees/quote to know it in advance.

Example:

"15.00"

amount_credited
string
required

What your balance moved by: amount_mwk minus fee, as an exact decimal string.

Example:

"985.00"

rail
enum<string> | null
required

How the money arrived: momo from a mobile wallet, bank from a bank account. Null when the rail could not be determined.

Available options:
bank,
momo,
null
source_customer_name
string | null
required

Who sent the money, as reported by the provider.

Example:

"PETER BANDA"

source_account_number
string | null
required

The account or wallet the money came from, verbatim — your handle for matching the pay-in to your own customer.

Example:

"265991234567"

source_institution
string | null
required

The institution the money came from, as reported by the provider.

Example:

"Airtel Money"

rtp_reference_number
string | null
required

The reference you supplied when requesting this payment, echoed back for matching. Null when the payer sent the money directly.

created_at
string<date-time>
required