Skip to main content
PATCH
https://api.sandbox.wepayout.com.br
/
v2
/
account
/
markup
/
{markupId}
Update Merchant Markup
curl --request PATCH \
  --url https://api.sandbox.wepayout.com.br/v2/account/markup/{markupId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "mode": "<string>",
  "amount": 123,
  "min_charge_value": 123,
  "max_charge_value": 123,
  "enabled": true
}
'
{
  "id": 1234,
  "product": "payin",
  "payment_method": "pix",
  "account_id": 987,
  "parent_id": null,
  "type": "global",
  "mode": "fixed",
  "amount": 10.0,
  "min_charge_value": null,
  "max_charge_value": null,
  "enabled": false,
  "created_at": "2025-01-01 12:00:00",
  "updated_at": "2025-01-10 09:30:00"
}

​
Update Merchant Markup

Use this endpoint to update an existing markup configuration for a merchant, identified by its markupId.

​
Business Rules

Important Restrictions:
  • This feature launches in January 2026

​
Path Parameters

​
markupId
integer
required
Unique identifier of the markup configuration to be updated.

​
Request Body

​
mode
string
Markup mode to be applied.Allowed values:
  • fixed
  • percent
Business rules:
  • Required if you send any of these fields: amount, min_charge_value, max_charge_value.
​
amount
number
Markup value to be applied.Constraints:
  • Optional
  • Must be greater than or equal to 0.01
​
min_charge_value
number
Minimum markup amount when mode is percent.Business rules:
  • Required when mode = percent
  • Prohibited when mode = fixed
  • Must be greater than or equal to 0.01
​
max_charge_value
number
Maximum markup amount when mode is percent.Business rules:
  • Optional
  • Must be greater than or equal to min_charge_value
  • Prohibited when mode = fixed
​
enabled
boolean
Flag to enable or disable this markup configuration.
  • Optional
  • Allowed values: true, false
Mode and range rules
  • If you send any of amount, min_charge_value or max_charge_value, you must also send mode.
  • When mode = fixed, you must not send min_charge_value or max_charge_value.
  • When mode = percent, you must send min_charge_value, and max_charge_value is optional but must be greater than or equal to min_charge_value when provided.
Special rule when changing modeIf you change the mode from percent to fixed, the service will internally reset:
  • min_charge_value = null
  • max_charge_value = null

​
Request Examples

curl -X PATCH "https://api.sandbox.wepayout.com.br/v2/account/markup/1234" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "fixed",
    "amount": 10.0,
    "enabled": false
  }'

​
Response

​
id
integer
Markup configuration ID.
​
product
string
Product where the markup is applied (e.g., payin).
​
payment_method
string
Payment method where the markup is applied (e.g., pix).
​
account_id
integer
Merchant ID that receives the markup.
​
parent_id
integer or null
Parent relationship ID, when applicable.
​
type
string
Markup scope type. Example: global.
​
mode
string
Markup mode. Example: fixed or percent.
​
amount
number
Markup value configured for this rule.
​
min_charge_value
number or null
Minimum markup value when mode is percent.
​
max_charge_value
number or null
Maximum markup value when mode is percent.
​
enabled
boolean
Indicates whether the markup configuration is currently active.
​
created_at
string
Date and time when the markup configuration was created.
​
updated_at
string
Date and time when the markup configuration was last updated.
{
  "id": 1234,
  "product": "payin",
  "payment_method": "pix",
  "account_id": 987,
  "parent_id": null,
  "type": "global",
  "mode": "fixed",
  "amount": 10.0,
  "min_charge_value": null,
  "max_charge_value": null,
  "enabled": false,
  "created_at": "2025-01-01 12:00:00",
  "updated_at": "2025-01-10 09:30:00"
}