Internal Capability Requests

Decline capability 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

Request

  • Base URL
    https://api.paymongo.com
  • URL
    https://api.paymongo.com/v1/internal/requests/{id}/decline
  • Auth
    HTTP bearer

Path parameters

idstring required

Request ID

Request body

internal_notestring
merchant_notestring

MerchantNote is an optional merchant-safe decline reason. It is stored (with the timestamp it was set) in the request's dedicated merchant_note column, 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

OK

has_moreboolean

Example response

{
  "data": {
    "account_id": "acct_01hzy8n3k2b5xq9m4p7r6t8w1v",
    "id": "req_01hzy8n3k2b5xq9m4p7r6t8w1v",
    "product_code": "prd_svc_paymongo_ewallet_gcash",
    "request_type": "onboarding",
    "requester_id": "org_01hzy8n3k2b5xq9m4p7r6t8w1v"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.