These docs are for v2.1. Click to read the latest docs for v4.1.

Cobrança para facilitadores de pagamento

Por obrigatoriedade das bandeiras e do Banco Central, para atender os sub-adquirentes que queiram transacionar online, todas as transações enviadas devem conter informações adicionais que permitam a identificação do submerchant pela bandeira.

Com o objeto sub_merchant na API de Charge, permitimos a criação de uma cobrança de pagamento de um sub-adquirente, através desse método é possível utilizar apenas dados essenciais para efetivação de uma cobrança de acordo com o método de pagamento escolhido.

Métodos de pagamento disponíveis:

  • Cartão de Crédito

Atenção: Para começar a operar como sub-credenciador, é preciso que sua conta esteja habilitada para esta função. Procure o seu executivo comercial e solicite essa ativação.

Ponto Importante: Por padrão, MCCs de alto risco são bloqueados. Se o seu negócio realiza esse tipo de transação, é preciso informar ao seu executivo comercial para que suas transações sejam liberadas.

curl --location --request POST 'https://sandbox.api.pagseguro.com/charges' \
--header 'Authorization: {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reference_id": "ID123456789",
    "description": "Motivo de pagamento",
    "amount": {
        "value" : "100",
        "currency" : "BRL"
    },
    "payment_method": {
        "type": "CREDIT_CARD",
        "installments": 1,
        "capture": false,
        "soft_descriptor": "LojaDoJoao",
        "card": {
            "number": "4916642720407380",
            "exp_month": "06",
            "exp_year": "2021",
            "security_code": "513",
            "holder": {
                "name": "Jose da Silva"
            }
        }
    },
    "sub_merchant": {
        "name": "João Souza",
        "reference_id": "ID123456789",
        "tax_id": "12345678908",
        "mcc": "1554",
        "address": {
            "country": "BRA",
            "region_code": "SP",
            "city": "Sao Paulo",
            "postal_code": "01452002",
            "street": "Avenida Brigadeiro Faria Lima",
            "number": "1384",
            "locality": "Pinheiros",
            "complement": "Apto 16"
        },
        "phones": [
            {
                "country": "55",
                "area": "11",
                "number": "911111111",
                "type": "MOBILE"
            }
        ]
    },
    "notification_urls": [
        "https://webhookdojoao.com/"
    ]
}'
{
    "id": "CHAR_B29BD467-EB28-4DCE-927A-9DE0CEB36B84",
    "reference_id": "TesteGet2",
    "status": "AUTHORIZED",
    "created_at": "2021-09-22T14:41:51.410-03:00",
    "description": "Motivo de pagamento",
    "amount": {
        "value": 100,
        "currency": "BRL",
        "summary": {
            "total": 100,
            "paid": 0,
            "refunded": 0
        }
    },
    "payment_response": {
        "code": "20000",
        "message": "SUCESSO",
        "reference": "25700000700"
    },
    "payment_method": {
        "type": "CREDIT_CARD",
        "installments": 1,
        "capture": false,
        "capture_before": "2021-09-27T14:41:55.041-03:00",
        "card": {
            "brand": "visa",
            "first_digits": "491664",
            "last_digits": "7380",
            "exp_month": "6",
            "exp_year": "2021",
            "holder": {
                "name": "Jose da Silva"
            }
        },
        "soft_descriptor": "OrcNaoSobreesc"
    },
    "sub_merchant": {
        "reference_id": "OrcSub",
        "name": "Felipe Olimpio",
        "tax_id": "12345678908",
        "mcc": "1554",
        "address": {
            "city": "Sao Paulo",
            "postal_code": "01452002",
            "street": "Avenida Brigadeiro Faria Lima",
            "number": "1384",
            "locality": "Pinheiros",
            "country": "BRA",
            "region_code": "SP",
            "complement": "Apto 16"
        },
        "phones": [
            {
                "country": "55",
                "area": "11",
                "number": "988778877",
                "type": "MOBILE"
            }
        ]
    },
    "notification_urls": [
        "https://webhook.site/936a276f-16da-4766-af82-fcf19bc22232"
    ],
    "links": [
        {
            "rel": "SELF",
            "href": "https://sandbox.api.pagseguro.com/charges/CHAR_B29BD467-EB28-4DCE-927A-9DE0CEB36B84",
            "media": "application/json",
            "type": "GET"
        },
        {
            "rel": "CHARGE.CANCEL",
            "href": "https://sandbox.api.pagseguro.com/charges/CHAR_B29BD467-EB28-4DCE-927A-9DE0CEB36B84/cancel",
            "media": "application/json",
            "type": "POST"
        },
        {
            "rel": "CHARGE.CAPTURE",
            "href": "https://sandbox.api.pagseguro.com/charges/CHAR_B29BD467-EB28-4DCE-927A-9DE0CEB36B84/capture",
            "media": "application/json",
            "type": "POST"
        }
    ]
}