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 Order, permitimos a criação de pedido 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/orders' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"reference_id": "ex-00001",
"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": 500
}
],
"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"
}
},
"notification_urls": [
"https://meusite.com/notificacoes"
],
"charges": [
{
"reference_id": "MY-ID-123",
"description": "Motivo de pagamento",
"amount": {
"value": 1000,
"currency": "BRL"
},
"payment_method": {
"type": "CREDIT_CARD",
"installments": 1,
"capture": true,
"soft_descriptor": "Loja do meu teste",
"card": {
"number": "4111111111111111",
"exp_month": "03",
"exp_year": "2026",
"security_code": "123",
"holder": {
"name": "Jose da Silva"
}
}
},
"sub_merchant": {
"reference_id": "MY-ID",
"name":"Razão Social / Nome completo",
"tax_id": "42167200803",
"mcc": "155",
"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": "98877887788",
"type": "MOBILE"
}
]
},
"notification_urls": [
"https://yourserver.com/nas_ecommerce/277be731-3b7c-4dac-8c4e-4c3f4a1fdc46/"
]
}
]
}'
{
"id": "ORDE_3F3EA44E-6A82-4D52-BC23-94DF2096A1FD",
"reference_id": "ex-00001",
"created_at": "2023-02-08T17:44:34.959-03:00",
"customer": {
"name": "Jose da Silva",
"email": "[email protected]",
"tax_id": "12345678909",
"phones": [
{
"type": "MOBILE",
"country": "55",
"area": "11",
"number": "999999999"
}
]
},
"items": [
{
"reference_id": "referencia do item",
"name": "nome do item",
"quantity": 1,
"unit_amount": 500
}
],
"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_1F7CAB6E-6311-4225-82F8-77355CCA1E30",
"reference_id": "MY-ID-123",
"status": "PAID",
"created_at": "2023-02-08T17:44:35.385-03:00",
"paid_at": "2023-02-08T17:44:35.000-03:00",
"description": "Motivo de pagamento",
"amount": {
"value": 1000,
"currency": "BRL",
"summary": {
"total": 1000,
"paid": 1000,
"refunded": 0
}
},
"payment_response": {
"code": "20000",
"message": "SUCESSO",
"reference": "032416400102"
},
"payment_method": {
"type": "CREDIT_CARD",
"installments": 1,
"capture": true,
"card": {
"brand": "visa",
"first_digits": "411111",
"last_digits": "1111",
"exp_month": "3",
"exp_year": "2026",
"holder": {
"name": "Jose da Silva"
}
},
"soft_descriptor": "Lojadomeuteste"
},
"sub_merchant": {
"reference_id": "MY-ID",
"name": "Razão Social / Nome completo",
"tax_id": "42167200803",
"mcc": "155",
"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": "98877887788",
"type": "MOBILE"
}
]
},
"links": [
{
"rel": "SELF",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_1F7CAB6E-6311-4225-82F8-77355CCA1E30",
"media": "application/json",
"type": "GET"
},
{
"rel": "CHARGE.CANCEL",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_1F7CAB6E-6311-4225-82F8-77355CCA1E30/cancel",
"media": "application/json",
"type": "POST"
}
]
}
],
"notification_urls": [
"https://meusite.com/notificacoes"
],
"links": [
{
"rel": "SELF",
"href": "https://sandbox.api.pagseguro.com/orders/ORDE_3F3EA44E-6A82-4D52-BC23-94DF2096A1FD",
"media": "application/json",
"type": "GET"
},
{
"rel": "PAY",
"href": "https://sandbox.api.pagseguro.com/orders/ORDE_3F3EA44E-6A82-4D52-BC23-94DF2096A1FD/pay",
"media": "application/json",
"type": "POST"
}
]
}