Split de pagamentos

Cobrança imediata com split

Com esta funcionalidade você pode criar um QR Code de cobrança na sua conta e fazer split para outras contas ValidaPay.

Case de uso:

Como SaaS, tenho parceiros/afiliados PF ou PJ. Quero gerar cobranças na minha conta preenchendo apenas o valor do produto e fazer split para as contas dos meus parceiros.

POST/v1/charges/pix
Base URL Produção:https://api.validapay.com.br
Base URL Sandbox:https://sandbox.validapay.com.br

Authorizations

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",
            "accountNumber": "896532569", 
            "amount": 0.10
        },
        {
            "type": "fixed",
            "accountNumber": "125485692", 
            "amount": 0.10
        }
    ]
}

Schema

FieldTypeRequiredDescription
amount
numberRequiredValor com precisão de duas casas decimais separado por ponto
split[2]
array--
const url = 'https://sandbox.validapay.com.br/v1/charges/pix';

const options = {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer {{token}}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "amount": 1.00, 
    "split": [
        {
            "type": "fixed",
            "accountNumber": "896532569", 
            "amount": 0.10
        },
        {
            "type": "fixed",
            "accountNumber": "125485692", 
            "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_1881511282731_9p1wo5plk,
    "emv": "00020101021226910014br.gov.bcb.pix2569qrcode.pix.celcoin.com.br/pixqrcode/v2/77e66fbad26b0b294eeb56c7c7c29f5204000053039865802BR5909ValidaPix6013Florianopolis62070503***6304BA13"
}