Inviting accounts to an offer
Offers are not broadcast to all merchants. You must explicitly invite specific accounts by their account ID and set an expiry for their invitation window:
curl -XPOST https://api.paymongo.com/v1/capitals/lenders/offers/{offer_id}/accounts -H "Content-Type: application/json" -d \
'{
"accounts": [
{
"id": "org_01HX...",
"expires_at": "2026-05-05T00:00:00Z"
}
]
}'You can invite up to 25 accounts per request. Once invited, the account sees the offer in Dashboard → Capital with the full fee disclosures and a data-sharing consent screen.
Active offer required. You can only invite accounts to an offer with status: active. If the offer is not active (for example inactive or deleted), the endpoint returns 404 not_found. Setting an offer to inactive also hides it from every merchant already invited and blocks their new applications. To resume, set the offer back to active with PUT /v1/capitals/lenders/offers/{offer_id}.
Duplicate account IDs. If the same account ID appears more than once in a single request's accounts array, only the first entry is recorded, and its expires_at is used. Every entry is still validated, so an invalid repeated entry fails the whole request with 422. Accounts that already hold an unexpired invitation to this offer are skipped, and their existing expires_at is not extended.
Expiry format. expires_at must be a future RFC 3339 date-time. A malformed value returns 422 invalid_request_body.
Expiry behavior. When expires_at passes and the merchant has not yet submitted an application, the invitation is automatically invalidated and the offer no longer appears in the merchant's Dashboard. To re-engage the merchant, issue a new invitation with a future expires_at.
Updated about 1 month ago
