Getting Started

This page provides a general overview of the Victor API and environments. When you're ready to continue, visit Generating a Token.

API Access

This guide assumes you have access to one of our environments, visit Request API Access for more information.

Authentication

The Victor API uses JSON Web Tokens (JWTs) and API keys to authenticate each request. Each JWT is signed with your private key and the API key is added as subject claim to the JWT payload.

Date and Time Format

The Victor APIs use the ISO 8601 date and time format and require the time zone to be set to Zulu time (Z). For example, complete date plus hours, minutes, seconds, and a decimal fraction of a second use the format YYYY-MM-DDThh:mm:ss.sTZD (eg 1997-07-16T19:20:30.45Z).

Environments

The Victor Platform provides support for both Staging (testing) and Production (live) Environments. Requests made to the Staging environment will not hit banking networks and therefore can't affect your account balances and will not incur costs. API keys generated in one environment will not be valid in another environment. In order to avoid confusion, each environment has its own URL:

💡

Info

Staging Environment: https://api.stage.victorfi.com
Production Environment: https://api.victorfi.com

Idempotency

The Victor create payment APIs allow clients to provide an optional idempotency header (Idempotency-Key) to safely retry the request without accidentally processing the same request multiple times. When creating a payment, add an idempotency key to the request header to repeat the request without the risk of creating duplicate transactions.

An idempotency key is a client provided unique value which the server uses to recognize subsequent retries of the same request. Victor recommends using UUIDs to avoid collisions. Idempotency keys can be up to 128 characters long.

Responses

Victor uses conventional HTTP response codes to indicate the success or failure of a request. Codes in the 2xx range indicate success, codes in the 4xx range indicate a failure due to the information in your request, and codes in the 5xx range indicate an issue with the Victor Platform.

Next Steps

In the next section we'll go over how to Generate a Token to authenticate with the Victor API.