Initiate Application

1. To enable a Merchant to process payments with getpaid, the platform initiates the onboarding for the Merchant calling /applications. This call will just initiate an onboarding application for the Merchant.

2. The /applications API is secured, and the platform will have to pass a JWT token to /applications , the token will be obtained calling /token endpoint.

3. The response contains the URL which the platform will have to send to the Merchant, so the Merchant can provide the required information for the checks. The _links.redirect.href field contains the hosted onboarding page URL. Platforms should redirect the Merchant to this URL so they can complete the onboarding process.

The following diagram shows the flow and actors to initiate an onboarding application :

Sample /applications request

You can see all details of the /application API.

Live

POST https://api.getpaid.io/applications

Sandbox

POST https://api.sandbox.getpaid.io/applications

Sample request

curl --location --request POST 'https://api.sandbox.getpaid.io/applications' \
-H 'authorization: Bearer {{your_access_token}}' \
-H 'content-type: application/json' \
-d '{
  "applicant": {
    "email": "jon.smith@acme.com",
    "first_name": "Jon",
    "last_name": "Smith"
  },
  "currencies": [
    "EUR"
  ],
  "integration": {
    "type": "hosted"
  },
  "language": "en",
  "reference": "merch-001",
  "urls": {
    "webhook": "http://example.com"
  }
}'

Sample responses

200 - Success

{
  "id": "app_44678r08jtm8zbt227tzhc4nw5",
  "reference": "merch-001",
  "merchant_id": "acc_4zjjxn0nm1tnweqbttedkvnsc8",
  "_links": {
    "redirect": {
      "href": "https://hop.getpaid.io/app_44678r08jtm8zbt227tzhc4nw5"
    }
  }
}

422 - Invalid parameters

{
  "type": "https://docs.getpaid.io/overview/getting-started#422---invalid-parameters",
  "title": "Invalid Parameters",
  "trace_id": "96ce50247f87f540bb2d86771b3728b8",
  "status": 422,
  "detail": "The request body was invalid",
  "errors": {
    "applicant.email": [
    "'email' is not a valid email address."
    ]
  }
}

Application status

We send webhook notifications when the compliance checks on an application are completed.

EVENT	DESCRIPTION
Application Succeeded	Application compliance checks are completed successfully.
Application Action Required	More information is needed in order to complete the compliance checks.