v1

latestOpenAPI 3.1.02026-07-24233206489.1 KB

internal-requests

Decline onboarding request (S2S only)

Transitions request status from under_review to declined. Records the decline action with optional internal note.

post/v1/internal/requests/{id}/decline

Path parameters

idstring required

Request ID

Request body

accountIDstring

adminIDstring

idstring required

internal_notestring

merchant_notestring

MerchantNote is an optional merchant-safe decline reason. It is stored as the merchant_note key inside the request's kyb_data, so merchants can read it from GET /v1/requests. Do not put internal-only context here — use internal_note.

Example request

{
  "internal_note": "Business documents fail KYB verification",
  "merchant_note": "Please resubmit your business registration documents"
}

Response

has_moreboolean

Example response

{
  "data": {
    "account_id": "acct_01hzy8n3k2b5xq9m4p7r6t8w1v",
    "product_code": "prd_svc_paymongo_ewallet_gcash",
    "request_type": "onboarding",
    "requester_id": "usr_01hzy8n3k2b5xq9m4p7r6t8w1v"
  }
}