Split de pagamentos
Split para Conta Master
Com esta funcionalidade você pode criar um QR Code de cobrança na conta de um Seller e fazer split para a sua conta.
Case de uso:
Como SaaS tenho vários Sellers, cada um deles possui uma subconta ValidaPay. Quero gerar cobranças para qualquer subconta preenchendo apenas o valor do produto e fazer split para a minha conta Master
⚠️ Atenção: O número da subconta é retornado via webhook quando a subconta é aprovada.
Use externalTxid para identificar a loja, o caixa ou o vendedor responsável pela cobrança.
/v1/charges/pixhttps://api.validapay.com.brhttps://sandbox.validapay.com.brAuthorizations
Authorization
string · header · required
Cabeçalho de autenticação Bearer no formato Bearer {{token}} onde {{token}} é o seu token OAuth2.
Escopos requeridos
Body
application/json
{
"amount": 1.00,
"externalTxid": "loja-01-caixa-03",
"split": [
{
"type": "fixed",
"amount": 0.10
}
]
}Schema
amountnumberRequiredValor com precisão de duas casas decimais separado por ponto
externalTxidstringOptionalaté 100 caracteresIdentifica a loja, o caixa ou o vendedor responsável pela cobrança
split[1]arrayHeaders
| Name | Type | Value | Required | Description |
|---|---|---|---|---|
| X-Sub-Account | text | {{subaccount_number}}(variável) | Required | Subconta da cobrança |
const url = 'https://sandbox.validapay.com.br/v1/charges/pix';
const options = {
method: 'POST',
headers: {
'Authorization': 'Bearer {{token}}',
'X-Sub-Account': '{{subaccount_number}}',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"amount": 1.00,
"externalTxid": "loja-01-caixa-03",
"split": [
{
"type": "fixed",
"amount": 0.10
}
]
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));Response Examples
{
"chargeId": "cha_15631511282731_9p1wo5ghu",
"emv": "00020101021226910014br.gov.bcb.pix…"
}