---
agentTools:
  projectIndex: https://docs.mundipagg.com/llms.txt
---

# Cartão private label

Para criar um [pedido](https://docs.mundipagg.com/v1/reference#criar-pedido) com **cartão private label**, devemos incluir o objeto `private_label` dentro do nó `payment`, assim como a propriedade `"payment_method": "private_label"`. O objeto `private_label` contêm os seguintes atributos:

[block:parameters]
{
  "data": {
    "0-0": "`installments`",
    "0-1": "**integer**",
    "1-0": "`statement_descriptor`",
    "1-1": "**string**",
    "2-0": "`capture`",
    "2-1": "**boolean**",
    "3-0": "`card`, `**card_id**` ou `card_token`",
    "3-1": "**object**",
    "4-0": "`metadata`",
    "4-1": "**object**",
    "0-2": "_Quantidade de parcelas_. Valor padrão: `1`.",
    "1-2": "_Texto exibido na fatura do cartão_. Max: 22 caracteres.",
    "2-2": "_Indica se o pagamento deve ser processado imediatamente_. Caso seja `false` o pagamento deverá ser confirmado posteriormente. Valor padrão: `true`.",
    "3-2": "_Cartão private label_. \n`card_id` é o identificador do cartão de um cliente.\n`card_token` é o token do cartão gerado pelo checkout transparente. [Saiba mais sobre cartões](https://docs.mundipagg.com/v1/reference#cart%C3%B5es).",
    "4-2": "_Objeto chave/valor utilizado para armazenar informações adicionais sobre o pagamento_.",
    "h-0": "Atributos",
    "h-1": "Tipo",
    "h-2": "Descrição"
  },
  "cols": 3,
  "rows": 5
}
[/block]

[block:callout]
{
  "type": "warning",
  "title": "Liberação de private label",
  "body": "Para transacionar um cartão private label via Mundipagg é necessário entrar em contato com nosso suporte através do e-mail: [suporte@mundipagg.com](mailto:suporte@mundipagg.com) e solicitar uma análise e abertura de projeto."
}
[/block]

[block:code]
{
  "codes": [
    {
      "code": "{\n    \"items\": [\n        {\n            \"amount\": 2990,\n            \"description\": \"Chaveiro do Tesseract\",\n            \"quantity\": 1\n        }\n    ],\n    \"customer\": {\n        \"name\": \"Tony Stark\",\n        \"email\": \"avengerstark@ligadajustica.com.br\"\n    },\n    \"payments\": [\n        {\n            \"payment_method\": \"private_label\",\n            \"private_label\": {\n                \"capture\": true,\n                \"installments\": 1,\n                \"statement_descriptor\": \"AVENGERS\",\n                \"card\": {\n                    \"number\": \"4716806755265342\",\n                    \"holder_name\": \"Tony Stark\",\n                    \"label\": \"Private Label\",\n                    \"exp_month\": 1,\n                    \"exp_year\": 20,\n                    \"cvv\": \"151\"\n                }\n            },\n            \"metadata\": {\n                \"plan_id\": \"003000\"\n            }\n        }\n    ],\n}",
      "language": "json",
      "name": "Request cartão private label (Pedido)"
    },
    {
      "code": "{\n    \"id\": \"or_57oxkMntecE1P6JO\",\n    \"code\": \"PGW5F69IX6\",\n    \"amount\": 2990,\n    \"currency\": \"BRL\",\n    \"closed\": true,\n    \"items\": [\n        {\n            \"id\": \"oi_DZlmrdXfXQcmr5kO\",\n            \"description\": \"Chaveiro do Tesseract\",\n            \"amount\": 2990,\n            \"quantity\": 1,\n            \"status\": \"active\",\n            \"created_at\": \"2019-01-21T18:37:48Z\",\n            \"updated_at\": \"2019-01-21T18:37:48Z\",\n            \"order\": {\n                \"id\": \"or_57oxkMntecE1P6JO\",\n                \"code\": \"PGW5F69IX6\",\n                \"amount\": 2990,\n                \"closed\": true,\n                \"created_at\": \"2019-01-21T18:37:48Z\",\n                \"updated_at\": \"2019-01-21T18:37:48Z\",\n                \"closed_at\": \"2019-01-21T18:37:48Z\",\n                \"currency\": \"BRL\",\n                \"status\": \"paid\",\n                \"customer_id\": \"cus_n3bqEzdsZUmNA7Qp\",\n                \"items\": [\n                    {\n                        \"id\": \"oi_DZlmrdXfXQcmr5kO\",\n                        \"description\": \"Chaveiro do Tesseract\",\n                        \"amount\": 2990,\n                        \"quantity\": 1,\n                        \"status\": \"active\"\n                    }\n                ]\n            }\n        }\n    ],\n    \"customer\": {\n        \"id\": \"cus_n3bqEzdsZUmNA7Qp\",\n        \"name\": \"Tony Stark\",\n        \"email\": \"avengerstark@ligadajustica.com.br\",\n        \"delinquent\": false,\n        \"created_at\": \"2019-01-21T18:36:30Z\",\n        \"updated_at\": \"2019-01-21T18:36:30Z\",\n        \"phones\": {}\n    },\n    \"status\": \"paid\",\n    \"created_at\": \"2019-01-21T18:37:48Z\",\n    \"updated_at\": \"2019-01-21T18:37:48Z\",\n    \"closed_at\": \"2019-01-21T18:37:48Z\",\n    \"charges\": [\n        {\n            \"id\": \"ch_PNbX8jDIPuL1p5nM\",\n            \"code\": \"PGW5F69IX6\",\n            \"amount\": 2990,\n            \"paid_amount\": 2990,\n            \"status\": \"paid\",\n            \"currency\": \"BRL\",\n            \"payment_method\": \"private_label\",\n            \"paid_at\": \"2019-01-21T18:37:48Z\",\n            \"created_at\": \"2019-01-21T18:37:48Z\",\n            \"updated_at\": \"2019-01-21T18:37:48Z\",\n            \"customer\": {\n                \"id\": \"cus_n3bqEzdsZUmNA7Qp\",\n                \"name\": \"Tony Stark\",\n                \"email\": \"avengerstark@ligadajustica.com.br\",\n                \"delinquent\": false,\n                \"created_at\": \"2019-01-21T18:36:30Z\",\n                \"updated_at\": \"2019-01-21T18:36:30Z\",\n                \"phones\": {}\n            },\n            \"last_transaction\": {\n                \"id\": \"tran_G1byLaJUXHm5Eg4R\",\n                \"transaction_type\": \"private_label\",\n                \"gateway_id\": \"82c0acb3-75b0-48b8-a3ac-0e51c4b3744c\",\n                \"amount\": 2990,\n                \"status\": \"captured\",\n                \"success\": true,\n                \"installments\": 1,\n                \"statement_descriptor\": \"AVENGERS\",\n                \"acquirer_tid\": \"a4cf3de1-beb2-4724-822d-ac7ad14fa306\",\n                \"acquirer_nsu\": \"a4cf3de1-beb2-4724-822d-ac7ad14fa306\",\n                \"acquirer_auth_code\": \"903\",\n                \"acquirer_message\": \"Transação capturada com sucesso\",\n                \"acquirer_return_code\": \"00\",\n                \"operation_type\": \"auth_and_capture\",\n                \"card\": {\n                    \"id\": \"card_apxQeXJsV2fGVwPL\",\n                    \"first_six_digits\": \"400000\",\n                    \"last_four_digits\": \"0010\",\n                    \"brand\": \"Visa\",\n                    \"holder_name\": \"Tony Stark\",\n                    \"exp_month\": 1,\n                    \"exp_year\": 2030,\n                    \"status\": \"active\",\n                    \"type\": \"credit\",\n                    \"private_label\" true,\n                    \"created_at\": \"2019-01-21T18:37:48Z\",\n                    \"updated_at\": \"2019-01-21T18:37:48Z\",\n                    \"billing_address\": {\n                        \"zip_code\": \"90265\",\n                        \"city\": \"Malibu\",\n                        \"state\": \"CA\",\n                        \"country\": \"US\",\n                        \"line_1\": \"10880, Malibu Point, Malibu Central\"\n                    }\n                },\n                \"created_at\": \"2019-01-21T18:37:48Z\",\n                \"updated_at\": \"2019-01-21T18:37:48Z\",\n                \"gateway_response\": {\n                    \"code\": \"200\",\n                    \"errors\": []\n                }\n            }\n        }\n    ],\n    \"checkouts\": []\n}",
      "language": "json",
      "name": "Response cartão private label (Pedido)"
    }
  ]
}
[/block]

[block:api-header]
{
  "title": "Status da transação de cartão private label (Transaction)"
}
[/block]

As transações de Cartão Private Label podem possuir os seguintes status dependendo da regra de negócio definida pela processadora do cartão:

[block:parameters]
{
  "data": {
    "0-0": "`authorized_pending_capture`",
    "1-0": "`not_authorized`",
    "2-0": "`captured`",
    "3-0": "`partial_capture`",
    "4-0": "`waiting_capture`",
    "5-0": "`refunded`",
    "6-0": "`voided`",
    "7-0": "`partial_refunded`",
    "8-0": "`partial_void`",
    "9-0": "`error_on_voiding`",
    "10-0": "`error_on_refunding`",
    "11-0": "`waiting_cancellation`",
    "12-0": "`with_error`",
    "13-0": "`failed`",
    "14-0": "",
    "0-1": "Autorizada pendente de captura",
    "1-1": "Não autorizada",
    "2-1": "Capturada",
    "3-1": "Capturada parcialmente",
    "4-1": "Aguardando captura",
    "5-1": "Estornada",
    "6-1": "Cancelada",
    "7-1": "Estornada parcialmente",
    "8-1": "Cancelada parcialmente",
    "9-1": "Erro no cancelamento",
    "10-1": "Erro no estorno",
    "11-1": "Aguardando cancelamento",
    "12-1": "Com erro",
    "13-1": "Falha",
    "14-1": "",
    "h-0": "Status",
    "h-1": "Descrição"
  },
  "cols": 2,
  "rows": 14
}
[/block]