List IPN Messages
List the webhook messages issued for your account.
Each item of results is the message exactly as it was delivered to your webhook, with the same message_id, event_type, issue_datetime and payload you received. The message_id is what tells a message you already processed apart from one you did not. Use it to look up a notification you did not process, or to reconcile what was sent against what you have on your side.
Messages are returned newest first, and every filter can be combined. The result is always restricted to your own account.
Messages issued before this endpoint was released carry no creation date and no recorded operation: they are listed, but the date_gte, date_lte and operation_type filters leave them out.
Authorizations
B2B’s White Label API uses OAuth2. Currently there is only one supported authentication flow:
- clientCredentials allows you to access your own B2B account (First-Party Integration) and performs transactions against the public API. This oauth2 flow is well suited for this API, as it allows machine-to-machine communication.
Every call to the API has to be authenticated with an OAuth2 Token. In order to request this token, you will need to have sandbox or production API Keys (client id and client secret) that will be needed to generate a credential in order to negotiate an ephemeral access token.
Every request must be accompianed by an Authorization header with a value that follows the following schema: Bearer ACCESS_TOKEN
Query Parameters
Return messages issued on or after this date. ISO 8601 datetime, e.g. 2026-03-01T00:00:00Z.
Return messages issued on or before this date. ISO 8601 datetime, e.g. 2026-03-31T23:59:59Z.
Filter by the operation the message is about. Repeat the parameter to ask for several at once, e.g. ?operation_type=DEPOSIT&operation_type=WITHDRAWAL. It is the prefix of the message event_type, except for end user messages, which are filtered as END_USER and delivered as USER.<status>.
DEPOSIT, WITHDRAWAL, SWAP, AUTOSWAP, FIAT_DEPOSIT, FIAT_WITHDRAWAL, END_USER, P2P_LATAM, P2P_BATCH, LOAN, LOAN_TOP_UP, LOAN_REPAYMENT, LOAN_LIQUIDATION Filter by delivery status. COMPLETED means your endpoint acknowledged the message; PENDING means it is still being retried.
PENDING, COMPLETED Filter by the webhook the message was sent to. Useful when your account has more than one configured.
Filter by transaction identifier. Returns every message issued for that transaction.
Filter by end user external reference. Returns every message about that user, both the ones notifying the user itself and the ones about their operations.
Filter by P2P batch identifier.
Sort order. Defaults to newest first.
-created_at, created_at, -id, id Number of messages to return per page.
Index of the first message to return.
Response
OK
Total count of messages matching the filters.
123
Indicates next page by URL.
"https://api.ripio.com/api/v1/ipn/messages/?limit=50&offset=50"
Indicates previous page by URL.
Messages as they were delivered to your webhook. The keys of payload depend on the event: see the Webhooks pages for the structure of each one.