Get Transaction Status

This endpoint allows you to get transaction information. The request can be configured to only return the data that is necessary for your specific use case.

SecurityBearer Authentication
Request
path Parameters
transaction-id
required
string

The transaction id of the transaction for which the transaction status is requested. (The Ratepay Payment API returns this when an transaction is created.)

Example: 12-3456789123456789
header Parameters
Content-Type
required
string
Example: application/json
Authorization
required
string

For each request, a valid access token must be provided in the Authorization header. See Authentication API for obtaining a valid token.

Responses
200

Is returned if transaction status information is returned for the given transaction_id

404

Is returned if transaction_id is unknown.

405

Is returned if the endpoint is called with a request method other than GET

406

Is returned if the request accept header does not specify JSON as an accepted content type for the response.

415

Is returned if the request does not contain content type headers or if the request content type is anything other than JSON.

422

Is returned incase Transaction Status API unable to process request.

500

Is returned in case of a technical server error at Ratepay. Try again later.

get/transaction/status/v2/transactions/{transaction-id}
Request samples
Response samples
application/json;charset=UTF-8
{
  • "ratepay_transaction_id": "12-3456789123456789",
  • "partner_transaction_id": "test-shop-transaction-id",
  • "created": "2020-03-10T18:06:52.438+01:00",
  • "shop_buyer_id": "test-shop-buyer-id",
  • "currency": "EUR",
  • "shop_baskets": [
    ],
  • "payment_information": {
    }
}