# Submit a decision for a merchant onboarding request

This endpoint allows a loyalty partner to approve or reject a merchant onboarding request. When approving, a loyaltyProgramId must be provided. When rejecting, an optional reason may be provided.

Endpoint: POST /locations/merchant-onboarding/loyalty/{onboardingReference}
Version: 1.0
Security: JWT

## Path parameters:

  - `onboardingReference` (string, required)
    The unique reference identifier for the merchant onboarding request.

## Header parameters:

  - `Authorization` (string, required)

## Request fields (application/json):

  - `action` (string, required)
    The decision to approve or reject the merchant onboarding request.
    Enum: "APPROVE", "REJECT"

  - `loyaltyProgramId` (string)
    The loyalty program identifier to associate with this merchant. Required when action is APPROVE.

  - `reason` (string)
    An optional reason for the rejection. Only applicable when action is REJECT.

## Response 400 fields (application/json):

  - `error` (string)
    The validation error message.

## Response 404 fields (application/json):

  - `error` (string)
    The error message.

## Response 409 fields (application/json):

  - `error` (string)
    The error message.

## Response 422 fields (application/json):

  - `error` (string)
    The error message.


## Response 200 fields

## Response 401 fields

## Response 403 fields