Quickstart
Your first VALIDIF payment
Four steps from account creation to a received payment event.
Steps
01
Create your account
Sign up, then open your company workspace. Every company only ever sees its own data.
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.
03
Create a payment
Call the payment intents endpoint with an idempotency key.
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.
