TSP

This end point should be used when the TPP receives a callback directly from the bank after authorization is completed. This endpoint is for both v1 and v2 requests.

Initiate a callback

The POST /callback/initiation endpoint processes a bank authorization callback notification. If you're responsible for handling callbacks, the bank will callback to your callbackUrl provided in the payment initiation, after the user finishes authentication at the bank. Send the query of the bank's callback url to Token.io via the POST /callback/initiation endpoint to process the payment.

SecurityBearer or BasicAuth
Request
header Parameters
request-timeout
integer

Sets the number of elapsed seconds until Token.io sends the response back, even if the call is not finished by that time (in which case the call will be completed asynchronously).

Example: 10
Request Body schema: application/json
required
query
string

The URL-encoded string of all query parameters returned by the bank in the callback received by the client.

Example: "param1=value1&param2=value2"
Responses
200

Successful response

400

The client specified an invalid argument

401

The authorization information is missing or invalid

403

Permission to access this endpoint is denied

404

The requested entity, such as a payment, was not found

429

Too many requests

500

An unexpected or internal server error

501

The operation was not implemented

503

Service is unavailable

504

Gateway has timed out

post/callback/initiation
Request samples
application/json
{
  • "query": "param1=value1&param2=value2"
}
Response samples
application/json
{
  • "tokenRequestId": "rq:ej5ACWNwi1EcqBeuDPc4Z8C4Bgc:5zKtXEAq",
  • "redirectUrl": "redirect-url",
  • "fields": {
    }
}
➔ Next to Webhooks