Criar split de pedido
POST
/v1/orders/{orderId}/split-order
Divide o valor líquido de um pedido entre um ou mais recebedores. Os
valores são informados em centavos e cada linha referencia um
recipient_hash previamente aprovado (Onboarding completed).
Valores e taxas
O split é limitado ao partner_total — valor do pedido menos as taxas
da Appmax. A taxa é descontada automaticamente do marketplace; não
envie taxa no payload. Se a soma ultrapassar o partner_total, a
divisão é proporcional e o último recebedor recebe apenas o residual,
sem retorno de erro.
Autorizações
bearerAuth
Token Bearer do merchant obtido via POST /oauth2/token usando as
credenciais do merchant (não do app). Veja
Autenticação.
Tipo
HTTP (bearer)
Parâmetros
Parâmetros de Caminho
orderId*
ID do pedido na Appmax.
Tipo
Obrigatóriointeger
Exemplo
1Corpo da Requisição
application/json
JSON "split": [ { "amount": 1000, "recipient_hash": "d9bd0dae-3274-5e5a-939f-f50d867eb652", "refund_charge_percentage": 0 }, { "amount": 500, "recipient_hash": "d9bd0dae-3274-5e5a-939f-f50d867eb653", "refund_charge_percentage": 0 } ]
{
}
Respostas
Split criado com sucesso.
application/json
POST
/v1/orders/{orderId}/split-order