redirectUri to Advance company application and use sessionUrl.
How it works
- Create a company.
- Submit the Universal KYB pack on Advance company application with
method: UNIVERSAL_KYB. The first call creates the application. Later calls with the same method amend it. - Upload each outstanding document from
nextAction. Company documents use Upload application documents. Beneficial-owner identity documents use Upload related person documents. - When
nextAction.typeisSUBMIT, call Submit company application. The company moves toIN_REVIEW. - Reap reviews the application and sends
COMPANY_STATUS_UPDATED.
REGISTER_OF_DIRECTORS and BUSINESS_REGISTRY.
Pack
Sendmethod: UNIVERSAL_KYB plus the verified business data. Countries in the pack use ISO 3166-1 alpha-3 codes and dates use YYYY-MM-DD. See Advance company application for the exact fields and limits.
Required:
- Company identity: legal business name, legal form, and business registration number.
- Addresses: the registered address and the principal place of business.
- Line of business: the code that best describes what the company does.
- Email domains: between 1 and 10 domains the company’s staff use for email.
- Beneficial owners: at least one. For each owner, send your own identifier for them, their ownership percentage, their name, date of birth and nationality, their residential address, and between 1 and 3 identity documents (type, number and issuing country).
- Date of incorporation and business website.
ddq(due diligence questionnaire): card authorities (name and role), the expected spend profile, and the number of employees.edd(enhanced due diligence): written source-of-funds and source-of-wealth declarations. Back them with theSOURCE_OF_FUNDSandSOURCE_OF_WEALTHdocuments below.
nextAction lists what is still required:
DOCUMENT_UPLOADwith the outstanding company documents and any outstandingUBO_IDENTITYitems (relatedPersonId+uboDocumentType)SUBMITwhen required uploads are completenullafter submit, or for Managed KYB
Documents
Upload one document type per request.Company documents
Accepted formats: JPEG, PNG, GIF, PDF, Word (DOC, DOCX), Excel (XLS, XLSX), and CSV. Maximum 5 files per request and 5 MB total. Send a multi-page document as one PDF or as several files in the same request.
Beneficial-owner documents
Each beneficial owner needs a file for every identity document you declared for them in the pack. Reap accepts these identity documents:PASSPORT: the photo page.ID_CARD: a government-issued national identity card, front and back.DRIVERS_LICENCE: a government-issued driver’s licence, front and back.
Incomplete submissions
If you submit before every required document is uploaded, the API returns400 with code: COMPANY_APPLICATION_INCOMPLETE, plus missing and invalid, so you can fix every gap in one pass. When the outstanding items are documents, documents lists each one in the same shape as nextAction.documents, including relatedPersonId and uboDocumentType for beneficial-owner documents.
Review
Reap’s compliance team reviews every submitted application. Reap does not approve a company automatically and ask for documents later: the company staysIN_REVIEW until the review ends, and moves to one of these statuses:
ACTIVE: Reap approved the company. The review also decides whether you can issue cards to the company’s employees and which of the declared email domains Reap validated. See Corporate Employees.ACTION_REQUIRED: Reap needs more information. Reap sends the request to you as the program, not to your customer. Your account manager tells you what is needed, you collect it from your customer, and the review continues once Reap has it.REJECTED: Reap declined the company. Contact your account manager.
ACTIVE, it cannot hold accounts or issue cards, and you cannot create employee users under it. Reap sends COMPANY_STATUS_UPDATED on each status change.
Testing in sandbox
Simulation runs the same completeness check and sends the sameCOMPANY_STATUS_UPDATED webhook as a real review.
- Submit a complete application as described in How it works.
- Call Simulate company status with
ACTIVE,REJECTED,ACTION_REQUIRED, orCANCELLED. - Wait for
COMPANY_STATUS_UPDATED. The simulate call returns204and the new status arrives with the webhook.
SIMULATION_INVALID_STATE. IN_REVIEW cannot be simulated because submit produces it. ACTIVE does not need applicationDetails. Reap uses the submitted application.
Managed KYB
Projects configured for Managed KYB keep the existing flow. Send onlyredirectUri (or method: MANAGED_KYB with redirectUri). The response still includes sessionUrl. nextAction is null. Get and list application stay the same resource shape.