Quickstart

Your first VALIDIF payment

Four steps from account creation to a received payment event.

Steps

  1. 01

    Create your account

    Sign up, then open your company workspace. Every company only ever sees its own data.

  2. 02

    Generate an API key

    Keys are created from your workspace. The secret value is shown once, at creation, and never stored in clear text.

  3. 03

    Create a payment

    Call the payment intents endpoint with an idempotency key.

  4. 04

    Receive the event

    Your endpoint receives the payment event; ingested events are also listed in your workspace with masked payloads.

Create a payment

Amounts are integers in the minor unit — 250000 is 2 500,00 XOF.

POST /v1/payment_intents

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"
  }'

Next

Read Authentication, Payments and Webhooks, then check the Sandbox and Production pages.