Developers

Built for developers, not around them.

A predictable REST API, idempotent creation calls, signed webhooks and normalized errors. Start in Sandbox with a key you generate yourself.

Get your API key Read the documentation

Quickstart

create-payment-intent.sh

curl https://api.validif.com/v1/payment_intents \
  -H "Authorization: Bearer vl_sec_xxxxx" \
  -H "Idempotency-Key: order_98231" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 250000,
    "currency": "XOF",
    "capture_method": "automatic"
  }'

Documentation

Introduction

Base URL, environments, idempotency and normalized errors.

Authentication

Secret keys, scopes per environment and key rotation.

Payments

Payment intents: create, authorize, capture, cancel, list.

Payouts

Create payouts, follow statuses and handle failures.

Webhooks

Event format, signature verification and retries.

Errors

Every error code, HTTP status and how to react to it.

Sandbox and Production

Sandbox

Build, integrate and test. Sandbox keys are self-served from your dashboard and no real funds are processed.

Production

Process real transactions after approval. Production access is reviewed before it is enabled for your company.

From first key to first webhook.

Create your company, generate a Sandbox key and follow the quickstart.

Start building Request Production Access