Cartão de débito

Para criar uma cobrança ou um pedido com cartão de débito, devemos incluir o objeto debit_card dentro do nó payment, assim como a propriedade "payment_method": "debit_card". O objeto debit_card contêm os seguintes atributos:

Atributos

Tipo

Descrição

statement_descriptor

string

Texto exibido na fatura do cartão. Max: 22 caracteres.

card, card_id ou card_token

object

Cartão de crédito.
card_id é o identificador do cartão de um cliente.
card_token é o token do cartão gerado pelo checkout transparente. Saiba mais sobre cartões.

recurrence

boolean

Indica se é uma cobrança/pedido de recorrência. Valor padrão: false

metadata

object

Objeto chave/valor utilizado para armazenar informações adicionais sobre o pagamento.

merchant_category_code

integer

Código de classificação do ramo de atuação do lojista.

authentication

object

Objeto que indica se a transação de débito é autenticada ou não.

payload

object

_Objeto de dados criptografados, tais como: GooglePay, ApplePay e SamsungPay

Para os casos em que a transação é autenticada, o objeto authentication é obrigatório. Ele possui os seguintes campos:

type

string

Indica o tipo de autenticação utilizado. Atualmente o único tipo suportado é threed_secure

threed_secure

object

Indica os campos a serem enviados para a autenticação 3DS.

Por fim, o objeto threed_secure contém os seguintes campos:

Atributos

Tipo

Tamanho máximo

Descrição

mpi

string

11

Indica quem é o autenticador da transação. Pode receber os valores "acquirer" para transações autenticadas pela adquirente ou "third_party" para autenticadores externos.

eci

string

2

Indica o resultado da tentativa de autenticação. Obrigatório quando o mpi é "third_party".

cavv

string

256

Código de autenticação do dono do cartão. Obrigatório quando o mpi é "third_party".

transaction_id

string

256

id da transação no autenticador. Obrigatório quando o mpi é "third_party".

ds_transaction_id

string

256

Identificador da transação no Directory Service

version

string

6

Versão do 3D-S

success_url

string

512

Url de redirecionamento quando a transação é aprovada pelo autenticador. Obrigatório quando o mpié "acquirer".

📘

Autenticação 3DS

Quando a autenticação é feita por um autenticador do tipo acquirer, só é necessário enviar os campos mpi e redirect_url. Os campos mpi, eci, cavv e transaction_id são os necessários para uma transação com autenticação externa.

{
    "items": [
        {
            "amount": 2990,
            "description": "Chaveiro do Tesseract",
            "quantity": 1
        }
    ],
    "amount":"2990",
    "customer": {
        "name": "Tony Stark",
        "email": "[email protected]"
    },
    "payments":[{
        "payment_method": "debit_card",
        "debit_card": {
            "statement_descriptor": "AVENGERS",
            "card": {
                "number": "4000000000000010",
                "holder_name": "Tony Stark",
                "exp_month": 12,
                "exp_year": 30,
                "cvv": "235"
            },
            "authentication": {
                "type": "threed_secure",
                "threed_secure": {
                    "mpi": "acquirer",
                    "success_url": "http://www.mundipagg.com"
                }
            }
        },
        "metadata": {
            "mundipagg_payment_method_code": "62"
        }
    }]
}
{
  "id": "or_7K8A8vkCmtLDG5Xl",
  "code": "XMWI23FMYL",
  "amount": 2990,
  "currency": "BRL",
  "closed": true,
  "items": [
    {
      "id": "oi_4MrX5mRc9UWVX985",
      "description": "Chaveiro do Tesseract",
      "amount": 2990,
      "quantity": 1,
      "status": "active",
      "created_at": "2019-09-30T16:20:48Z",
      "updated_at": "2019-09-30T16:20:48Z"
    }
  ],
  "customer": {
    "id": "cus_rdK4yjmHRdUe8LJl",
    "name": "Tony Stark",
    "email": "[email protected]",
    "delinquent": false,
    "created_at": "2019-09-30T15:38:58Z",
    "updated_at": "2019-09-30T15:38:58Z",
    "phones": {}
  },
  "status": "pending",
  "created_at": "2019-09-30T16:20:48Z",
  "updated_at": "2019-09-30T16:20:48Z",
  "closed_at": "2019-09-30T16:20:48Z",
  "charges": [
    {
      "id": "ch_oAk1KDXIvMCLbgav",
      "code": "XMWI23FMYL",
      "amount": 2990,
      "status": "pending",
      "currency": "BRL",
      "payment_method": "debit_card",
      "created_at": "2019-09-30T16:20:48Z",
      "updated_at": "2019-09-30T16:20:48Z",
      "customer": {
        "id": "cus_rdK4yjmHRdUe8LJl",
        "name": "Tony Stark",
        "email": "[email protected]",
        "delinquent": false,
        "created_at": "2019-09-30T15:38:58Z",
        "updated_at": "2019-09-30T15:38:58Z",
        "phones": {}
      },
      "last_transaction": {
        "id": "tran_10ELvKJtGnTNmxk2",
        "transaction_type": "debit_card",
        "gateway_id": "db0ad0b2-3556-49d2-9d52-16e6f9f4694f",
        "amount": 2990,
        "status": "pending_authentication",
        "success": true,
        "statement_descriptor": "AVENGERS",
        "acquirer_tid": "658cbfcd-29bc-4c22-89c3-ee7fa755e214",
        "acquirer_nsu": "658cbfcd-29bc-4c22-89c3-ee7fa755e214",
        "acquirer_message": "Transação não autorizada",
        "acquirer_return_code": "01",
        "operation_type": "capture",
        "mpi": "acquirer",
        "authentication_type": "threed_secure",
        "threed_authentication_url": "https://simulatorpages.mundipagg.com/ThreeDS/transactionKeyToAcquirer=db0ad0b2-3556-49d2-9d52-16e6f9f4694f&amount=2990",
        "card": {
          "id": "card_aYVpJ6xCQMU2pDk1",
          "first_six_digits": "400000",
          "last_four_digits": "0010",
          "brand": "Visa",
          "holder_name": "Tony Stark",
          "exp_month": 12,
          "exp_year": 2030,
          "status": "active",
          "type": "credit",
          "created_at": "2019-09-30T15:38:59Z",
          "updated_at": "2019-09-30T15:38:59Z",
          "customer": {
            "id": "cus_rdK4yjmHRdUe8LJl",
            "name": "Tony Stark",
            "email": "[email protected]",
            "delinquent": false,
            "created_at": "2019-09-30T15:38:58Z",
            "updated_at": "2019-09-30T15:38:58Z",
            "phones": {}
          }
        },
        "created_at": "2019-09-30T16:20:48Z",
        "updated_at": "2019-09-30T16:20:48Z",
        "gateway_response": {
          "code": "200"
        },
        "antifraud_response": {}
      },
      "metadata": {
        "mundipagg_payment_method_code": "62"
      }
    }
  ],
  "checkouts": []
}

Status das transações de Cartão de Débito (Transaction)

As transações de Cartão de Débito podem possuir os seguintes status:

Status

Descrição

not_authorized

Não autorizada

pending

Pendente

captured

Capturada

refunded

Estornada

error_on_refunding

Erro no estorno

with_error

Com erro

failed

Falha