FinaDOCS

Check Seller Eligibility

GET/fina/v1/sellers/check_eligibility

Check whether the sellers (sub-merchants) on your marketplace are eligible to have FINA BNPL orders placed on their behalf. Call it before Create Order for a seller you have not transacted with yet — an ineligible seller can't accept FINA regardless of the buyer's credit.

Marketplace only

Sellers are a marketplace concept — a direct merchant is always its own seller, so this endpoint is not part of the Direct Merchant integration.

Different envelope

This endpoint uses the { is_error, message, data } envelope. Business failures return HTTP 400 with is_error: true — unlike the checkout endpoints, which return HTTP 200 with a numeric error_code.

Request

arrayrequired

One or more seller phone numbers to check, in international format without the plus sign, passed as query-string parameters. Statuses are returned in the same order.

seller_phonestring

A seller's phone number in international format without the plus sign.e.g. 966543215678

Response

is_errorboolean

false on success.

messagestring

Human-readable status of the lookup.

object

Seller eligibility payload.

eligibilityenum

The overall decision. ELIGIBLE — every requested seller is ONBOARDED. INELIGIBLE — at least one seller is not onboarded; see reason and the per-seller sellers list.ELIGIBLEINELIGIBLE

reasonstring

Why the check is INELIGIBLE (e.g. SELLER_NOT_ONBOARDED). Empty when eligibility is ELIGIBLE.

array

Per-seller onboarding status, in the same order as the request.

Sandbox
GET /fina/v1/sellers/check_eligibility
curl -X GET "https://apibe.silqfi.xyz/fina/v1/sellers/check_eligibility?seller_phones=966543215678" \
  -H "Authorization: bearer FINA_BEARER_TOKEN"

FINA_BEARER_TOKEN is provided by the FINA team, per environment. Contact the FINA team for the production base URL.

Response · 200 · Eligible seller
{
  "is_error": false,
  "message": "Seller eligibility fetched.",
  "data": {
    "eligibility": "ELIGIBLE",
    "reason": "",
    "sellers": [
      { "phone": "966543215678", "status": "ONBOARDED" }
    ]
  }
}
PreviousError HandlingNext Check Eligibility