List Payment Notifications
GET/api/accounts/:partnerAccountId/payment-notifications
List payment event notifications for the given accountId.
The notification account id will be the same as the partner account
that owns the Card Program for the payments.
See Custodial Funding Protocol
for details about payment event notifications.
Results are paginated and ordered by descending createdAt
date.
Request
Path Parameters
Partner account id.
Query Parameters
Amount of records to return (max 100).
Cursor to retrieve the next page.
Filter for transactions from this date (inclusive). Value should be a ISO 8601 string.
Filter for transactions up to this date (inclusive). Value should be a ISO 8601 string.
Responses
- 200
- 400
- 403
Successful operation
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
items
object[]
Payment notification primary identifier.
Cardholder account this payment notification belongs to.
Funding Source this payment notification belongs to.
Timestamp of payment notification creation.
Payment id this notification belongs to.
Number of times this payment notification was attempted to be delivered.
Payment notification has been delivered successfully to the partner webhook.
lastDelivery
object
Last delivery attempt details. This can be empty if the payment notification is still scheduled for delivery. Response fields can be empty if there is no response from the partner webhook yet.
Payment notification payload sent to the partner webhook.
The url of the partner webhook this payment notification was attempted to be delivered to.
Timestamp of payment notification last delivery request.
The partner webhook response to this payment notification last delivery.
HTTP Response status code of this payment notification last delivery
Timestamp of Payment Notification last delivery response.
Number of milliseconds between the request and response
pageInfo
object
Page info for paginated results, undefined if no page info
Cursor for next page, undefined if no more pages
{
"items": [
{
"id": "91ad6fea3b52ca58d60d7fd310f789ec",
"accountId": "057aa15913a57f50577234c8426534c0",
"fundingSourceId": "6c474aa7a5dc45bff721b5a207cf0f47",
"createdAt": "2022-11-16T03:13:18.142Z",
"paymentId": "225d85e65495722bf6517ea0ba0d6f56",
"attempts": 1,
"delivered": true,
"lastDelivery": {
"requestBody": {
"messageType": "auth-request",
"messageId": "8f4db9a9558779a775232a77627a2dd1",
"eventType": "auth-requested",
"eventTimestamp": "2024-10-29T03:02:17.757Z",
"paymentId": "369284a071396e64d8d204e11eafb461",
"cardId": "ef384b85abe49a0d5611851a6ac864f4",
"cardholderId": "057aa15913a57f50577234c8426534c0",
"fundingSourceExternalId": "partner-cardholder-id-1",
"fundingSourceId": "6c474aa7a5dc45bff721b5a207cf0f47",
"paymentAmount": "6660000",
"paymentFeeAmount": "0",
"paymentCurrency": "USDC",
"paymentAcquirerAmount": "666",
"paymentAcquirerCurrency": "USD",
"paymentFinalized": "false",
"merchantCity": "Auckland",
"merchantCountryCode": "NZ",
"merchantId": "123456789012345",
"merchantName": "1 Queen Street",
"merchantTerminalId": "12345678",
"merchantCategoryCode": "1234",
"networkMessageRef": "010093436710290302140000012345600000000000"
},
"requestUrl": "https://api.partner.com/webhooks/notify",
"requestTimestamp": "2022-11-16T03:13:18.142Z",
"responseBody": {
"result": "authorized"
},
"responseStatus": 200,
"responseTimestamp": "2024-11-16T03:13:20.751Z",
"duration": 271
}
}
],
"pageInfo": {
"nextCursor": "dGhlIG5leHQgY3Vyc29yIGdvZXMgaGVyZQ=="
}
}
Request fields are invalid
- application/json
- Schema
- Example (from schema)
Schema
{
"statusCode": 400,
"statusName": "Bad Request",
"errorCode": "BAD_REQUEST",
"errors": [
"Expected string, received number"
]
}
No Authorization to access resource.
- application/json
- Schema
- Example (from schema)
Schema
{
"statusCode": 403,
"statusName": "Forbidden",
"errorCode": "FORBIDDEN",
"reason": "Unauthorized"
}