Get verification status

GET/partner/v1/business-profiles/{customerId}/verification-status

Auth Bearer tokenScope partner.read

Returns the compliance status of a business customer.

tip

Prefer webhooks to polling. Ryno sends customer.onboarding.approved, rejected and changes_requested as soon as a decision is made.

Path

customerIduuidpathrequired

From Create business profile.

Response

customerIduuid

verificationStatusstring

A verification status.

rejectionReasonstring | null

Set only when the status is Rejected or ChangesRequested.

Errors

Only the common errors.

Request

curl https://gateway.sandbox.rynopay.io/api/partner/v1/business-profiles/b3f1c2d4-.../verification-status \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Response

Pending

{
  "isSuccess": true,
  "error": { "code": "", "description": "", "type": 0 },
  "value": {
    "customerId": "b3f1c2d4-...",
    "verificationStatus": "PendingVerification",
    "rejectionReason": null
  }
}

Changes requested

{
  "isSuccess": true,
  "error": { "code": "", "description": "", "type": 0 },
  "value": {
    "customerId": "b3f1c2d4-...",
    "verificationStatus": "ChangesRequested",
    "rejectionReason": "Proof of address is older than three months."
  }
}