API explorerChangelog
Introduction

Sections

API explorer
Changelog

Theme switcher

Introduction

Was this section helpful?

What made this section unhelpful for you?

On this page
  • Introduction

Guides

On this page
  • Guides

API Keys & Access Security

Was this section helpful?

What made this section unhelpful for you?

On this page
  • API Keys & Access Security

Errors

In this guide, we will explore potential challenges that you might come across and discuss effective strategies for managing them. By addressing these issues, you can significantly enhance the efficiency of your development process.

Trace Request

On every response and webhook transaction a header is sent to track it, the name of this header is X-Trace-Id.

This information will be ask on any support request made so we can speed up the solution of any error ocurred.

Error response

If the request has not been successful, you will receive a JSON with the following attributes:

error_code: The error code that has occurred.

message: A message that describes the error.

Example

error_codestring
messagestring
Was this section helpful?

What made this section unhelpful for you?

1 2 3 4 { "error_code": "API_ERROR", "message": "Access denied. The API Key is not authorized to do this operation." }

Error Codes

200-201

The request executed had finished successfully.

400

The request is not valid, due to some unpredictable error. If you are using a POST, PUT or PATCH request, check that the body is valid. If you are using a GET request, check that the parameters are correct. If you are using a DELETE request, check the path.

401

The API Key is not authorized to do this operation. Check that your API Key had been correctly configured.

404

The requested resource does not exist. Some of the information needed to do this request was not found.

412

The request was not completed because an internal validation was not fulfilled. Check that the body of the request is valid.

500

Our APIs are currently experiencing issues. This is an error on our side, we will check as soon as possible. Please contact support and try again later.

Was this section helpful?

What made this section unhelpful for you?

API

On this page
  • API

Webhooks

On this page
  • Webhooks

Reissue Card

Warning: Once this method is successfully called, the previous card will be inactive and this operation is irreversible.

This endpoint allows you to generate a new number, CVV and expiry date for a given card.

When a card with a givencardID is lost, damaged or suspected of fraudulent use, this endpoint will generate a new number, CVV and expiry date for your card with the same cardID.

If the card was previously tokenized and provisioned to a mobile wallet (e.g. Google Pay), the newly created card should remain linked to the mobile wallet. However, for subscription-based services, the cardholder may need to re-enter the new card details and verify the card again. While the 16-digit Number, CVV, and expiry date will change, the cardIdremains the same as well the balance, movements and other information will remain unchanged.

Required access level: Admin Access (Level 3)

Was this section helpful?

What made this section unhelpful for you?

On this page
  • Reissue Card