Skip to main content
GET
Get bulk payment batch by ID
Get detailed information about a specific bulk payment batch.

Path Parameters

batchId
string
required

Response

200 - application/json

Bulk payment batch retrieved successfully

id
string
required

Payment ID

recipientName
string
required

Recipient name

recipientEmail
string
required

Recipient email

recipientPhone
string
required

Recipient phone

amount
number
required

Payment amount

currency
string
required

Currency

reference
string
required

Payment reference

status
string
required

Payment status

createdAt
string<date-time>
required

Created date

customerKey
string

Customer key if created

withdrawalId
string

Withdrawal ID if processed

errorMessage
string

Error message if failed

retryCount
number

Number of retry attempts made

network
string

Mobile network provider

telcoId
string

Telco receipt code from provider

fee
number

Total fee charged (provider cost + integrator fee)

transactionAmount
number

Total amount deducted from wallet (amount + fee)

completedAt
string<date-time>

Completed date