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.
POST
/v1/charges/pixBase URL Produção:
https://api.validapay.com.brBase URL Sandbox:
https://sandbox.validapay.com.brAuthorizations
bearer
Authorization
string · header · required
Cabeçalho de autenticação Bearer no formato Bearer {{token}} onde {{token}} é o seu token OAuth2.
Escopos requeridos
pix.cob/write
Body
application/json
Content-Type:application/json
{
"amount": 1.00,
"split": [
{
"type": "fixed",
"amount": 0.10
}
]
}Schema
| Field | Type | Required | Description |
|---|---|---|---|
amount | number | Required | Valor com precisão de duas casas decimais separado por ponto |
split[1] | array | - | - |
Headers
| 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,
"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
200200
{
"chargeId": cha_15631511282731_9p1wo5ghu,
"emv": "00020101021226910014br.gov.bcb.pix2569qrcode.pix.celcoin.com.br/pixqrcode/v2/77e66fbad26b0b294eeb56c7c7c29f5204000053039865802BR5909ValidaPix6013Florianopolis62070503***6304BA13"
}