Skip to main content
POST
https://api.sandbox.wepayout.com.br
/
v1
/
account
/
markup
Create Merchant
curl --request POST \
  --url https://api.sandbox.wepayout.com.br/v1/account/markup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_id": 123,
  "parent_id": 123,
  "product": "<string>",
  "payment_method": "<string>",
  "type": "<string>",
  "mode": "<string>",
  "amount": 123,
  "min_charge_value": 123,
  "max_charge_value": 123
}
'
{
  "id": 1,
  "product": "payin",
  "payment_method": "pix",
  "account_id": 123,
  "parent_id": null,
  "type": "global",
  "mode": "percent",
  "amount": 2.5,
  "min_charge_value": 1.0,
  "max_charge_value": 100.0
}
Coming Soon: This feature will be available soon. Stay tuned for updates!
Use this endpoint to configure markup rules for a merchant, defining how much additional amount will be charged per product and payment method.

​
Business Rules

Important Restrictions:
  • This feature launches in January 2026

​
Request Body

​
account_id
integer
required
ID of the merchant that will receive the markup.
​
parent_id
integer
Optional parent relationship ID. Can be used to associate this markup to a parent account or hierarchy level.
​
product
string
required
Product where the markup will be applied.Allowed values: payin, payout
​
payment_method
string
required
Payment method where the markup will be applied.Allowed values: pix, billet, credit_card
​
type
string
required
Markup scope type.Currently, only global is supported externally.
​
mode
string
required
Type of markup to be applied.Allowed values:
  • fixed: fixed amount per charge
  • percent: percentage over the charge amount
​
amount
number
required
Markup value to be applied.Constraints:
  • 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
When mode is fixed, do not send min_charge_value or max_charge_value.

​
Request Examples

{
  "account_id": 123,
  "product": "payin",
  "payment_method": "pix",
  "type": "global",
  "mode": "percent",
  "amount": 2.5,
  "min_charge_value": 1.0,
  "max_charge_value": 100.0
}

​
Response

​
id
integer
Markup configuration ID.
​
product
string
Product where the markup is applied.
​
payment_method
string
Payment method where the markup is applied.
​
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.
{
  "id": 1,
  "product": "payin",
  "payment_method": "pix",
  "account_id": 123,
  "parent_id": null,
  "type": "global",
  "mode": "percent",
  "amount": 2.5,
  "min_charge_value": 1.0,
  "max_charge_value": 100.0
}