Creates a capability request for one product_code on the account the credentials belong to — an account_id in the body is ignored for merchant keys. Only one open request per product code is allowed; an account_update is rejected only when it touches a field or document an open request already changes.

The account must be activated first: payment-method, tax-document and account-update requests are rejected with 400 until it is. Check a payment method with GET /v1/requests/eligibility/{product_code} before submitting.

kyb_data depends on product_code — pick its shape and an example from the request body below. Attach documents by sending multipart/form-data: the JSON body in a part named payload, plus one files_<purpose> part per document. Without documents, send plain application/json.

The request is created submitted. An account update that changes only business_size and/or business_age is approved on the spot and comes back completed; a request whose business website is on PayMongo's prohibited list comes back declined.

Per-product rules, the documents each business type needs, document purposes, upload limits and the request lifecycle are in the Capability requests API guide.