Submit Application
Use the POST method to submit an application. An application can be submitted only after all its required fields have been filled out and all required documents have been uploaded.
Note
An application cannot be modified after it has been submitted.
Prerequisites:
Create application for the proprietor type. For example, Create Application - Sole Prop. Card Present
Run Retrieve Application to ensure that there are no errors in the form that prevent it from being successfully submitted.
There are no body parameters for this request.
Sections object
Contains the data portion of the application. Contains these objects with their current values:
Sole Proprietor:
business- General information about the business itself.company- Information about the identity of the company.owner- Information about the owner of the company.
Non-Sole Proprietor:
business- General information about the business itself.company- Information about the identity of the company. All values are initially null.AU- Information about the authorized user or agent who is submitting the information on behalf of the company.shareholders_3- When relevant, includes information about the fourth owner of the business, including the high-level management executives hired by the business owners or board of directors.shareholders_2- When relevant, includes information about the third owner of the business, including the high-level management executives hired by the business owners or board of directors.shareholders_1- When relevant, includes information about the second owner of the business, including the high-level management executives hired by the business owners or board of directors.shareholders_0- Information about the first owner of the business, including the high-level management executives hired by the business owners or board of directors.
v1/partner/onboarding/application/:app_token/submit
Submit Application filled out correctly
curl -X POST api.rapyd.net/v1/partner/onboarding/application/app_f3b792abd8a64b89a32076b203248392/submit -H 'access_key: your-access-key-here' -H 'Content-Type: application/json' -H 'idempotency: your-idempotency-parameter-here' -H 'salt: your-random-string-here' -H 'signature: your-calculated-signature-here' -H 'timestamp: your-unix-timestamp-here' -H 'merchant_account_id: your-merchant-account-here'
{ "status": { "error_code": "", "status": "SUCCESS", "message": "Success", "response_code": "", "operation_id": "42e19078-152f-4675-9840-3b0f943d320b" }, "data": { "token": "app_f3b792abd8a64b89a32076b203248392", "version": 7, "status": "SUBMITTED", "ewallet_token": "ewallet_d69b982d41deca618c5ff3a6b1fcd2ab", "metadata": {}, "entity_type": "Government_Entity", "country": "FR", "created_at": 1751352565432, "updated_at": 1751353442293, "sell_type": "Physical Business (Brick and Mortar)", "business_industry": 4814, "sections": { "business": { "trade_name": { "trade_name": "Online Solutions" }, "product_description": { "business_desc": "Provide solutions" }, "url": { "business_url": "https://onlinepvtm.com" }, "transaction_information": { "avg_tpv_usd": "1", "expectedMaximumTransactionAmount": "2", "averageTimeBetweenPurchaseAndDeliveryInDays": "3", "annual_revenue": "4" }, "statement_descriptor": { "statement_descriptor": "online" }, "proof_of_address_document": { "address_ref": [ "sample_pdf.pdf" ] }, "proof_of_address": { "physical_address": "12th street", "address_additional_details": null, "postal_code": "75020", "city": "AnyTown", "state": null, "country": "FR" } }, "company": { "business_name": { "business_name": "Online Solutions" }, "phone": { "phone_country_code": "FR", "phone_number": "0109758351" }, "company_number": { "registration_number": "12345678900012" }, "address": { "address": "december street", "address_additional_details": null, "postal_code": "75020", "city": "AnyTown", "state": null, "us_state": null, "country": "FR" }, "company_documents": { "company_documents": [] }, "vat_id": { "tax_id": "FR12 345678901" } }, "AU": { "name": { "first_name": "Joe", "last_name": "Smith" }, "dob": { "dob": "12/12/1991" }, "address": { "address": "marady P O", "address_additional_details": null, "postal_code": "75020", "city": "AnyTown", "state": null, "country": "FR" }, "title": { "user_title": "Vice President" }, "email": { "email": "TEST12345@gmail12345.com" }, "nationality": { "nationality": "IS", "additional_citizenships": null }, "phone": { "phone_country_code": "FR", "phone_number": "0109758351" }, "identification": { "id_type": "National ID", "id": "X4RTBPFW4", "id_img": [ "image (1).png" ], "government_id_img": [] }, "proof_of_address_document": { "address_ref": [ "sample_pdf.pdf" ] } }, "shareholders_control": { "has_owner": { "shareholder_exists": "No" } }, "shareholder_3": { "type": { "shareholder_type": "Individual" }, "name": { "first_name": "Joekoeri", "last_name": "Smith" }, "ownership": { "ownership_percentage": "25" }, "dob": { "dob": "12/12/1996" }, "phone": { "phone_country_code": "FR", "phone_number": "0109758351" }, "email": { "email": "testnewnewnew@gmail12345.com" }, "nationality": { "nationality": "IS", "additional_citizenships": null }, "address": { "address": "address new", "address_additional_details": "address more", "postal_code": "75020", "city": "AnyTown", "state": null, "country": "FR" }, "ownership_proof": { "ownership_ref_type": [] } }, "shareholder_2": { "type": { "shareholder_type": "Individual" }, "name": { "first_name": "Joemarrow", "last_name": "Smith" }, "ownership": { "ownership_percentage": "25" }, "dob": { "dob": "12/12/1996" }, "phone": { "phone_country_code": "FR", "phone_number": "0109758351" }, "email": { "email": "testnewnew@gmail12345.com" }, "nationality": { "nationality": "IS", "additional_citizenships": null }, "address": { "address": "address new", "address_additional_details": "address more", "postal_code": "75020", "city": "NewTown", "state": "AnyState", "country": "FR" }, "ownership_proof": { "ownership_ref_type": [] } }, "shareholder_1": { "type": { "shareholder_type": "Individual" }, "name": { "first_name": "Joeyaol", "last_name": "Smith" }, "ownership": { "ownership_percentage": "25" }, "dob": { "dob": "12/12/1996" }, "phone": { "phone_country_code": "FR", "phone_number": "0109758351" }, "email": { "email": "testnew@gmail12345.com" }, "nationality": { "nationality": "IS", "additional_citizenships": [ "US", "FR" ] }, "address": { "address": "address new", "address_additional_details": null, "postal_code": "75020", "city": "NewTown", "state": null, "country": "FR" }, "ownership_proof": { "ownership_ref_type": [] } }, "shareholder": { "type": { "shareholder_type": "Individual" }, "name": { "first_name": "Joe", "last_name": "Smith" }, "ownership": { "ownership_percentage": "25" }, "dob": { "dob": "12/12/1990" }, "phone": { "phone_country_code": "FR", "phone_number": "0109758351" }, "email": { "email": "test@t1234567.com" }, "nationality": { "nationality": "IS", "additional_citizenships": null }, "address": { "address": "street 1", "address_additional_details": null, "postal_code": "75020", "city": "NewTown", "state": "Anystate", "country": "FR" }, "ownership_proof": { "ownership_ref_type": [] } } }, "link": "https://qaverify.rapyd.net/verify?token=happ_c9b521b121e849a8a6d3bc688a617bf1", "merchant_phone_number": { "country_code": "GB", "phone_number": "35445200" }, "instructions": "The application has been submitted and is being reviewed by Rapyd's onboarding team." } }
Submit Application already submitted successfully
curl -X POST api.rapyd.net/v1/partner/onboarding/application/app_52b6e2a06c3f4159aec5d22199e5282e/submit -H 'access_key: your-access-key-here' -H 'Content-Type: application/json' -H 'idempotency: your-idempotency-parameter-here' -H 'salt: your-random-string-here' -H 'signature: your-calculated-signature-here' -H 'timestamp: your-unix-timestamp-here' -H 'merchant_account_id: your-merchant-account-here'
{ "status": { "error_code": "ERROR_APPLICATION_ALREADY_SUBMITTED", "status": "ERROR", "message": "The request tried to save or submit an application, but the application has already been submitted. The request was rejected. Corrective action: None. Contact Client Support.", "response_code": "ERROR_APPLICATION_ALREADY_SUBMITTED", "operation_id": "a5ad6ca0-c803-4589-9cad-c098b1b37cd9" } }
Submit Application not correctly filled out
curl -X POST api.rapyd.net/v1/partner/onboarding/application/app_52b6e2a06c3f4159aec5d22199e5282e/submit -H 'access_key: your-access-key-here' -H 'Content-Type: application/json' -H 'idempotency: your-idempotency-parameter-here' -H 'salt: your-random-string-here' -H 'signature: your-calculated-signature-here' -H 'timestamp: your-unix-timestamp-here' -H 'merchant_account_id: your-merchant-account-here'
{ "status": { "error_code": "ERROR_APPLICATION_NOT_VALID", "status": "ERROR", "message": "The application cannot be submitted since at least one of its required fields does not have a valid value. Before attempting to resubmit, run the ‘Retrieve Application’ method to view the errors in the relevant fields, and then run the ‘Update Application’ method with the corrected field values.", "response_code": "ERROR_APPLICATION_NOT_VALID", "operation_id": "02d20185-afcb-41e6-b8a3-7250d05deef0" } }
Submit Application that must be filled out online
curl -X POST api.rapyd.net/v1/partner/onboarding/application/app_52b6e2a06c3f4159aec5d22199e5282e/submit -H 'access_key: your-access-key-here' -H 'Content-Type: application/json' -H 'idempotency: your-idempotency-parameter-here' -H 'salt: your-random-string-here' -H 'signature: your-calculated-signature-here' -H 'timestamp: your-unix-timestamp-here' -H 'merchant_account_id: your-merchant-account-here'
{ "status": { "error_code": "ERROR_UPDATE_ONBOARDING_APPLICATION_MCC_NOT_SUPPORTED", "status": "ERROR", "message": "The MCC in the request is not supported. The request was rejected. Corrective action: The application must be filled out via its hosted page. The link to the application's hosted page appears at the end of the response code. hosted link: https://qaverify.rapyd.net/verify?token=happ_dfe379b51cf64298bd7ec1b50d76d50b", "response_code": "ERROR_UPDATE_ONBOARDING_APPLICATION_MCC_NOT_SUPPORTED", "operation_id": "63a9be8d-d779-49f2-90af-1dfd9750a98a" } }