Submit KYC

MyTPE verifies who you are before you can accept payments. You submit three resources, and you can't request a payment instance until they're all accepted. Your token needs the kyc:write scope.

MyTPE reviews each resource. Its status moves from pending to accepted or refused. When a resource is refused, its reason field says why.

Submit the identification

1. Get the IDs you need. These lookups need no authentication. Each establishment type lists its authorization_types:

   curl https://api.mytpe.app/api/lookup/establishment-types
   curl https://api.mytpe.app/api/lookup/activities

2. Send the identification with its registration document. The document is a PDF, JPEG or PNG of at most 5 MB. An activity is required unless the establishment type is profession_liberale.

   curl -X POST https://api.mytpe.app/api/ext/identifications \
     -H "Authorization: Bearer $MYTPE_ACCESS_TOKEN" \
     -F "name=Boutique Centrale SARL" \
     -F "establishment_type_id=your-establishment-type-id" \
     -F "authorization_type_id=your-authorization-type-id" \
     -F "activity_id=your-activity-id" \
     -F "identification_file=@registre-commerce.pdf"

3. Wait for status to be accepted. To be notified, subscribe to the identification.approved and identification.rejected webhook events.

Submit a brand

A brand is what customers see on the payment page. It belongs to one identification.

curl -X POST https://api.mytpe.app/api/ext/brands \
  -H "Authorization: Bearer $MYTPE_ACCESS_TOKEN" \
  -F "name=Boutique Centrale" \
  -F "identification_id=your-identification-id" \
  -F "logo=@logo.png" \
  -F "file=@brand-document.png"

Submit a bank account

This is the 20-digit RIB that settlements are paid into. It belongs to one identification, and MyTPE derives bank_code from it.

curl -X POST https://api.mytpe.app/api/ext/bank-accounts \
  -H "Authorization: Bearer $MYTPE_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "account_number": "your-20-digit-rib", "identification_id": "your-identification-id" }'

What's next

When all three are accepted, request a payment instance.

For every field, see Identifications, Brands and Bank accounts.