Sign in
Kyc

Submit KYC fields and start any required verification

post/kyc/submit

Request body

emailstring required
fieldsobject

Optional KYC fields. country is the user’s current country of residence. Supported fields: email, first_name, last_name, phone, date_of_birth, country, BVN, NIN, and address.

countryCodestring required

ISO 3166-1 alpha-2 transaction/corridor country. Submit the user’s residence separately as fields.country.

provider'FONBNK' | 'ONRAMP_MONEY' | 'GUARDARIAN' | 'YELLOW_CARD' required
fiatCurrencystring required
callbackUrlstring

URL Didit should redirect the user to after external verification.

amountUsdnumber

Example request

{
  "email": "user@example.com",
  "fields": {
    "first_name": "Jane",
    "date_of_birth": "1990-01-01",
    "BVN": "12345678901",
    "NIN": "98765432109"
  },
  "countryCode": "NG",
  "provider": "YELLOW_CARD",
  "fiatCurrency": "NGN",
  "callbackUrl": "https://app.example.com/kyc/complete",
  "amountUsd": 100
}

Changes