Get Payment Notification
GET/api/payment-notifications/:messageId
Get a payment event notification by message id.
See Custodial Funding Protocol for details about payment event notifications.
Request
Path Parameters
Payment notification message id.
Responses
- 200
- 403
Successful operation
- application/json
- Schema
- Example (from schema)
Schema
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
{
"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
}
}
No Authorization to access resource.
- application/json
- Schema
- Example (from schema)
Schema
{
"statusCode": 403,
"statusName": "Forbidden",
"errorCode": "FORBIDDEN",
"reason": "Unauthorized"
}