v1

latestOpenAPI 3.1.02026-07-24233206489.1 KB
internal-requests

Process onboarding request to completion (S2S only)

Transitions request status to processing, updates organization data based on KYB data. Optionally change assignee via assignee_email parameter (omit to keep existing assignee, empty string to unassign, or provide valid email to reassign).

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

Path parameters

idstring required

Request ID

Request body

accountIDstring
adminIDstring
assignee_emailstring

AssigneeEmail is optional. If provided:

  • Empty string ("") or null: unassigns the request (sets AssigneeEmail to nil)
  • Valid email: assigns the request to that email If not provided (nil): keeps existing assignee unchanged (backward compatible)
idstring required
kyb_overridesobject

KybOverrides allows overriding specific KYB data values before updating Core organization If nil (not provided): Update all sections with KYB data (backward compatible) If empty map {}: Skip organization update entirely If provided with values: Override specific KYB fields before update

Accepted override keys (standard wallet):

  • business_age, business_size, business_tin, business_trade_name
  • business_address.city, business_address.country, business_address.line1, business_address.line2, business_address.postal_code, business_address.state
  • business_has_physical_stores, business_industry, business_description

Accepted override keys (e-wallet):

  • business_type, business_legal_name, customer_service_number, support_email
  • business_website, tax_gross_remittances, plugin
  • is_one_person_corporation (note: always updated regardless)

Accepted override keys (account activation):

  • account_type, business_type, business_trade_name
  • business_legal_name, business_dti_registered_name, business_description

Accepted override keys (account activation):

  • account_type, business_type, business_trade_name
  • business_legal_name, business_dti_registered_name, business_description

Example: {"business_type": "corporation", "business_address.city": "Manila"}

Example request

{
  "assignee_email": "ops@paymongo.com"
}

Response

OK

has_moreboolean

Example response

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