Fetch all Payments
Last updated Sept 24th, 2022
This resource returns all payment data on an account.
API Object
Request
123456789101112131415161718192021222324252627282930313233343536
{
"payments": [
{
"_id": "62bd8*****************9",
"type": "onetime-debit",
"status": "successful",
"amount": 20000,
"description": "description of payment",
"currency": "NGN",
"customer": null,
"reference": "KW9LO016***************3",
"created_at": "2022-06-30T11:14:10.583Z",
"updated_at": "2022-06-30T12:06:36.248Z",
"account": {
"_id": "62bd85***************",
"institution": {
"_id": "5f2d08********8********",
"name": "KudaBank",
"type": "PERSONAL_BANKING"
},
"name": "JOHN DOE EJIRO",
"accountNumber": "11********23",
"currency": "NGN",
"created_at": "2022-06-30T11:14:09.665Z",
"updated_at": "2022-06-30T13:00:00.096Z"
},
},
],
"paging": {
"total": 510,
"pages": 102,
"previous": null,
"next": "http://localhost:3000/transactions?page=2"
}
}
Payment Fields
Field | Description | Type |
payments | This is an array of objects which contains all payment data. | string |
payments._id | The payment Id. | string |
payment.type | The payment type. | string |
payment.status | The status of the payment. | string |
payment.amount | The payment's total value in the smallest denomination, such as a Kobo (Nigeria) or a Pesewa (Ghana). | number |
payment.description | The payment description. | string |
payment.currency | The currency of the payment account (NGN, GHS, etc). | string |
payment.customer | The Customer Id of the connected account. | string |
payment.reference | The unique identifier of the payment. | string |
payment.created_at | The date and time the payment was created. | string |
payment.updated_at | The date and time when the payment was updated. | string |
payment.account | The user information object. | string |
payment.account._id | The user account ID. | string |
payment.account.institution | The user's institution object. | string |
payment.account.institution._id | The user's institution ID. | string |
payment.account.institution.name | The user's institution name. | string |
payment.account.institution.type | The user's institution type. | string |
payment.account.name | The user's institution object. | string |
payment.account.accountNumber | The user's account number. | number |
payment.account.currency | The user's account currency. | string |
payment.account.created_at | The date and time the user account was connected. | string |
payment.account.updated_at | The date and time the user account was updated. | string |
paging | This object contains important pagination data such as the total, the current page, the previous and the next page link. | object |
paging.total | The total number of payments tied to this account. | number |
paging.page | The current page of the fetch all payments API. | number |
paging.previous | The previous page of the fetch all payments API. | string |
paging.next | The next page of the fetch all payments API. | object |