MarketPe APIs

Org Member Quota Increase

POST /org-member-quota/increase

Top up the payment limit (quota) for an org member. The amount is added to the member's postedQuota and availableQuota.

The org member receives a push notification when the top-up is applied.

Request

{
  "orgMemberId": "om-xxxxxx",
  "amount": 500,
  "idempotencyKey": "topup-2026-05-22-001",
  "comment": "Daily topup",
  "customFieldValues": {
    "cf-id-1": "Fooding",
    "cf-id-2": 23.5
  }
}

Request Parameters

ParameterTypeRequiredDescription
orgMemberIdstringYesThe id of the org member to top up.
amountnumberYesAmount to add to the limit. Must be > 0 and can have at most 2 decimal places.
idempotencyKeystringYesUnique key per top-up in your system. Retrying with the same key will not double-apply the top-up.
commentstringNoNote
customFieldValuesobjectNoCustom field values for this top-up. See Custom Field Values below.

Custom Field Values

Only pass this if you use custom fields that are configured in marketpe. For the list of custom fields configured for your org, contact us.

Response

{
  "status": "success",
  "data": {
    "id": "xxxxxx",
    "orgMemberId": "om-xxxxxx",
    "type": "increase",
    "amount": 500,
    "postedQuota": 5500,
    "availableQuota": 4000,
    "createdTime": "2026-05-22T09:30:00.000Z"
  }
}

Response Fields

FieldTypeDescription
idstringServer-generated id for this top-up.
orgMemberIdstringThe org member that was topped up.
typestringAlways "increase".
amountnumberThe amount from the request.
postedQuotanumberThe member's new postedQuota after this top-up.
availableQuotanumberThe member's new availableQuota after this top-up.
createdTimestringWhen the top-up was applied, ISO 8601 UTC.

Errors

Retrying with an idempotencyKey that was already used:

{
  "status": "error",
  "errorCode": "failed",
  "message": "A quota request with this idempotencyKey has already been applied.",
  "data": {
    "id": "xxxxxx",
    "orgMemberId": "om-xxxxxx",
    "type": "increase",
    "amount": 500,
    "postedQuota": 5500,
    "createdTime": "2026-05-22T09:30:00.000Z"
  }
}

data is the quota change that was already applied with this key.

Last updated on