Nessa opção, inicialmente o pedido é criado utilizando o endpoint Criar pedido. Acesse o caso de uso Criar pedido para maiores informações. O pagamento é realizado em uma segunda etapa utilizando o endpoint Pagar pedido. Você irá definir a divisão do pagamento nao pagar o pedido.
Para utilizar o endpoint Pagar pedido, você precisará informar o id do pedido a ser pago. Essa informação é obtida ao criar o pedido. No corpo da requisição você deve informar as informações do meio de pagamento que será utilizado através do objeto charges.
As informações da divisão do pagamento são informadas através do objeto charges.splits. Para definir a divisão do pagamento você precisará informar se utilizará a divisão percentual ou fixa. Além disso, precisa informar os id das contas de cada um dos recebedores e os valores que cada um receberá, sejam percentuais ou fixos. A descrição desses parâmetros é apresentada na tabela abaixo:
| Parâmetro | Descrição |
|---|---|
charges.splits.method | Define se a divisão será FIXEDou PERCENTAGE. |
charges.splits.receivers.account.id | Identificador único da conta PagBank do recebedor. |
charges.splits.receivers.amount.value | Valor destinado ao recebedor. Se a divisão for FIXED, esse valor é definido em centavos. Se a divisão for PERCENTAGE, esse valor é o percentual do montante total destinado ao recebedor. |
Abaixo você encontra um exemplo de requisição e resposta ao endpoint Pagar pedido.
curl --location --request POST 'https://sandbox.api.pagseguro.com/orders/{ORDE_XXXXXXXXXXXX }/pay' \
--header 'Authorization: Bearer TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '
{
"charges": [
{
"reference_id": "referencia do pagamento",
"description": "descricao do pagamento",
"amount": {
"value": 10000,
"currency": "BRL"
},
"payment_method": {
"type": "CREDIT_CARD",
"installments": 1,
"capture": true,
"card": {
"number": "4111111111111111",
"exp_month": "12",
"exp_year": "2026",
"security_code": "123",
"holder": {
"name": "Jose da Silva",
"tax_id": "65544332211"
},
"store": false
}
},
"splits": {
"method": "FIXED",
"receivers": [
{
"account": {
"id": "ACCO_12345"
},
"amount": {
"value": "6000"
}
},
{
"account": {
"id": "ACCO_67890"
},
"amount": {
"value": "4000"
}
}
]
}
}
]
}'
{
"id": "ORDE_F432482E-DFD1-476E-B5FB-3077B5E3A856",
"reference_id": "referencia do pedido",
"created_at": "2020-11-21T23:12:23.28-03:00",
"customer": {
"name": "Jose da Silva",
"email": "[email protected]",
"tax_id": "12345678909",
"phones": [
{
"country": "55",
"area": "11",
"number": "999999999",
"type": "MOBILE"
}
]
},
"items": [
{
"reference_id": "referencia do item",
"name": "nome do item",
"quantity": 1,
"unit_amount": 10000
}
],
"shipping": {
"address": {
"street": "Avenida Brigadeiro Faria Lima",
"number": "1384",
"complement": "apto 12",
"locality": "Pinheiros",
"city": "São Paulo",
"region_code": "SP",
"country": "BRA",
"postal_code": "01452002"
}
},
"charges": [
{
"id": "CHAR_3D4C63B5-B71E-418B-891E-660C79348C65",
"reference_id": "referencia da cobranca",
"status": "PAID",
"created_at": "2020-11-21T23:12:25.114-03:00",
"paid_at": "2020-11-21T23:12:25.737-03:00",
"description": "descricao da cobranca",
"amount": {
"value": 500,
"currency": "BRL",
"summary": {
"total": 500,
"paid": 500,
"refunded": 0
}
},
"payment_response": {
"code": "20000",
"message": "SUCESSO",
"reference": "1606011145716"
},
"payment_method": {
"type": "CREDIT_CARD",
"installments": 1,
"capture": true,
"card": {
"brand": "visa",
"first_digits": "411111",
"last_digits": "1111",
"exp_month": "12",
"exp_year": "2026",
"holder": {
"name": "Jose da Silva",
"tax_id": "65544332211"
}
}
},
"links": [
{
"rel": "SELF",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_3D4C63B5-B71E-418B-891E-660C79348C65",
"media": "application/json",
"type": "GET"
},
{
"rel": "CHARGE.CANCEL",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_3D4C63B5-B71E-418B-891E-660C79348C65/cancel",
"media": "application/json",
"type": "POST"
},
{
"rel": "SPLIT",
"href": "https://sandbox.api.pagseguro.com/splits/SPLI_4F0F18DD-184B-4ED1-BCBC-F3A58A3DC7A8",
"media": "application/json",
"type": "GET"
}
]
}
],
"links": [
{
"rel": "SELF",
"href": "https://sandbox.api.pagseguro.com/orders/ORDE_F432482E-DFD1-476E-B5FB-3077B5E3A856",
"media": "application/json",
"type": "GET"
},
{
"rel": "PAY",
"href": "https://sandbox.api.pagseguro.com/orders/ORDE_F432482E-DFD1-476E-B5FB-3077B5E3A856/pay",
"media": "application/json",
"type": "POST"
}
]
}
Na resposta da requisição você encontra o idjuntamente com o link para realizar consulta sobre o atual status da divisão do pagamento. Essa informação está disponível no parâmetro charges.links, onde você deve selecionar o objeto rel: SPLIT. No link disponibilizado você encontra o id da divisão do pagamento no formato SPLI_XXXXXXXXX.
{
"rel": "SPLIT",
"href": "https://sandbox.api.pagseguro.com/splits/SPLI_4F0F18DD-184B-4ED1-BCBC-F3A58A3DC7A8",
"media": "application/json",
"type": "GET"
}