Comprenez comment la soumission KYC, la revue et les limites impactent l’activation de votre compte.

Activation du compte et KYC

Le KYC fait partie du flux d’activation opérationnelle de Genuka Pay. Il impacte la conformité et les plafonds transactionnels.

Headers requis

Les requêtes KYC authentifiées doivent inclure :

X-Public-Key: YOUR_PUBLIC_KEY
X-Timestamp: UNIX_TIMESTAMP
X-Signature: HMAC_SHA256_SIGNATURE

Endpoints principaux

GET /api/v1/kyc/submission

POST /api/v1/kyc/submission

POST /api/v1/kyc/submission/documents

PUT /api/v1/kyc/submission/documents

DELETE /api/v1/kyc/submission/documents

POST /api/v1/kyc/submission/submit

POST /api/v1/kyc/submission/unlock

GET /api/v1/kyc/submission/requirements

POST /api/v1/kyc/submission/completeness

GET /api/v1/kyc/limits

Statuts de soumission

draft

submitted

under_review

approved

rejected

needs_info

Documents KYC entreprise typiques

BUSINESS_REGISTRATION

TAX_ID

COMPANY_STATUTES

BOARD_MINUTES

NON_BANKRUPTCY_CERTIFICATE

UTILITY_BILL

RENT_RECEIPT

Documents d’identité supportés dans d’autres scénarios :

ID_CARD

PASSPORT

NATIONAL_ID

PHOTO_ID

Récupérer les documents requis

curl -X GET "{{BASE_URL}}/api/v1/kyc/submission/requirements?entity_type=COMPANY" \
  -H "X-Public-Key: YOUR_PUBLIC_KEY" \
  -H "X-Timestamp: UNIX_TIMESTAMP" \
  -H "X-Signature: HMAC_SHA256_SIGNATURE"

Vérifier la complétude

curl -X POST "{{BASE_URL}}/api/v1/kyc/submission/completeness" \
  -H "X-Public-Key: YOUR_PUBLIC_KEY" \
  -H "X-Timestamp: UNIX_TIMESTAMP" \
  -H "X-Signature: HMAC_SHA256_SIGNATURE" \
  -H "Content-Type: application/json" \
  -d '{
    "entity_type": "COMPANY"
  }'

La réponse inclut :

score

is_complete

is_minimum_complete

les pourcentages de complétude mandatory/optional

Suivre les limites

curl -X GET "{{BASE_URL}}/api/v1/kyc/limits" \
  -H "X-Public-Key: YOUR_PUBLIC_KEY" \
  -H "X-Timestamp: UNIX_TIMESTAMP" \
  -H "X-Signature: HMAC_SHA256_SIGNATURE"

Flux recommandé

Compléter le profil entreprise

Démarrer une soumission KYC

Téléverser les documents requis

Vérifier le score de complétude

Soumettre pour revue

Suivre le statut jusqu’à approbation

Revérifier les limites avant de passer live

Modification après soumission

La plateforme supporte un flux de déverrouillage via POST /api/v1/kyc/submission/unlock.

Activation du compte et KYC

On this page