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.

Use externalTxid para identificar a loja, o caixa ou o vendedor responsável pela cobrança.

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, 
    "externalTxid": "loja-01-caixa-03",
    "split": [
        {
            "type": "fixed",
            "accountNumber": "896532569", 
            "amount": 0.10
        },
        {
            "type": "fixed",
            "accountNumber": "125485692", 
            "amount": 0.10
        }
    ]
}

Schema

amountnumberRequired

Valor com precisão de duas casas decimais separado por ponto

externalTxidstringOptional

Regra:até 100 caracteres

Identifica a loja, o caixa ou o vendedor responsável pela cobrança

split[2]array

← Anterior

Cobrança imediata

Split para Conta Master

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, 
    "externalTxid": "loja-01-caixa-03",
    "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.pix…"
}

← Anterior

Cobrança imediata

Split para Conta Master