--- updatedAt: 2026-04-06T17:50:50.000Z agentTools: projectIndex: https://docs.pagar.me/llms.txt --- # Cartão de débito Para criar um [pedido](https://docs.pagar.me/v5/reference#criar-pedido-2) 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, `card\_token`ou`network\_token\` **object** Cartão de débito.\ `card`: Informações referentes ao cartão do cliente.\ `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](https://docs.pagar.me/v5/reference#pagarme-js).\ `network_token`: Token referente a uma cartão gerado pelos serviços de tokenização das bandeiras.
`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](https://docs.pagar.me/reference/google-paytm-api)
`initiated_type` **string** Identificador do tipo de transação avulsa.\ Valores possíveis: `partial_shipment` (Remessa Parcial), `related_or_delayed_charge` (Cobrança Atrasada), `no_show` (Multa) ou `retry` (Retentativa).
`recurrence_model` **string** Identificador do tipo de recorrência.\ Valores possíveis: `standing_order` (Ordem Permanente), `instalment` (Parcelamento) ou `subscription` (Assinatura convencional com valor e frequência fixa).
`channel` **string** Identificador da origem da transação\ Valores possíveis: `payment_link`\ Necessário apenas para a bandeira Elo
> 🚧 Funcionalidade disponível apenas para clientes Gateway > > As funcionalidades apresentadas abaixo estão disponível apenas para clientes gateway 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 o valor "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*. | > 📘 Autenticação 3DS > > Os campos `mpi`, `eci`, `cavv` e `transaction_id` são os necessários para uma transação com autenticação externa. > ❗️ Atenção > > Atualmente é ofertado 2 versões para autenticação de transações. A versão 1.0 do 3DS será descontinuada e o Pagar.me está aceitando novas integrações apenas na versão 2.0 que apresenta melhor experiência para o portador e maior número de dispositivos suportados. > ❗️ Indicação de transações de link de pagamento > > A partir de 17 de outubro de 2025 será obrigatório identificar que uma transação foi originada através de um link de pagamento para cartões da bandeira Elo. > > No fluxo transacional, para indicar que uma transação é de link de pagamento é necessário enviar o campo `channel` com o valor `payment_link`. ```json Request cartão de débito com autenticação - 3DS (Pedido) { "amount": 1000, "code": "123", "customer": { "name": "Tony Stark" }, "currency": "BRL", "payment": { "payment_method": "debit_card", "operation_reference": "TESTEAPIDOCS", "debit_card": { "capture": false, "installments": 1, "statement_descriptor": "APIDOCS", "card": { "number": "4000000000000010", "holder_name": "Tony Stark", "exp_month": 11, "exp_year": 23, "cvv": "351" }, "authentication": { "type": "threed_secure", "threed_secure": { "mpi": "third_party", "eci": "05", "cavv": "BwABBylVaQAAAAFwllVpAAAAAAA=", "ds_transaction_id": "Nmp3VFdWMlEwZ05pWGN3SGo4TDA=", "version": "2" } } }, "metadata": { "mundipagg_payment_method_code": "19" } } } ``` ```json Request cartão de débito utilizando Network Token (Pedido) { "items": [ { "amount": 2990, "description": "Teste de débito", "quantity": 1, "code": "123" } ], "customer": { "name": "Tony Stark", "email": "TonyStark@gmail.com", "document": "93095135270", "type": "individual", "document_type": "CPF", "address": { "line_1": "375, Av. General Justo, Centro", "line_2": "8º andar", "zip_code": "20021130", "city": "Rio de Janeiro", "state": "RJ", "country": "BR" } }, "payments": [ { "payment_method": "debit_card", "debit_card": { "capture": false, "installments": 1, "statement_descriptor": "AVENGERS", "network_token": { "number": "5256621004565548", "holder_name": "Tony Stark", "exp_month": 12, "exp_year": 2023, "cryptograms": [ "ANfQt43bddROAAEnSAMhAAADFA====" ], "billing_address": { "street": "Malibu Point", "number": "10880", "zip_code": "90265", "neighborhood": "Central Malibu", "city": "Malibu", "state": "CA", "country": "US" } } }, } ] } ``` ```json Response cartão de débito utilizando Network Token (Pedido) { "id": "or_nEA3rVEC7TqOVWM2", "code": "W2NQAEJF3J", "amount": 2990, "currency": "BRL", "closed": true, "items": [ { "id": "oi_2jdEG82C8Cz5wLy4", "type": "product", "description": "Teste de débito", "amount": 2990, "quantity": 1, "status": "active", "created_at": "2023-04-14T18:13:25Z", "updated_at": "2023-04-14T18:13:25Z", "code": "123" } ], "customer": { "id": "cus_4qN8MKbCxt8aDovj", "name": "Tony Stark", "email": "TonyStark@gmail.com", "document": "93095135270", "document_type": "cpf", "type": "individual", "delinquent": false, "address": { "id": "addr_bve7jDhwvsm5orDk", "line_1": "375, Av. General Justo, Centro", "line_2": "8º andar", "zip_code": "20021130", "city": "Rio de Janeiro", "state": "RJ", "country": "BR", "status": "active", "created_at": "2023-04-14T18:13:16Z", "updated_at": "2023-04-14T18:13:16Z" }, "created_at": "2023-04-14T18:13:16Z", "updated_at": "2023-04-14T18:13:16Z", "phones": {} }, "status": "paid", "created_at": "2023-04-14T18:13:25Z", "updated_at": "2023-04-14T18:13:28Z", "closed_at": "2023-04-14T18:13:25Z", "charges": [ { "id": "ch_K83x0jXHMLumQalm", "code": "W2NQAEJF3J", "gateway_id": "f942829d-4a63-47b2-9af1-bef65ced0a5a", "amount": 2990, "paid_amount": 2990, "status": "paid", "currency": "BRL", "payment_method": "debit_card", "paid_at": "2023-04-14T18:13:27Z", "created_at": "2023-04-14T18:13:25Z", "updated_at": "2023-04-14T18:13:27Z", "customer": { "id": "cus_4qN8MKbCxt8aDovj", "name": "Tony Stark", "email": "TonyStark@gmail.com", "document": "93095135270", "document_type": "cpf", "type": "individual", "delinquent": false, "address": { "id": "addr_bve7jDhwvsm5orDk", "line_1": "375, Av. General Justo, Centro", "line_2": "8º andar", "zip_code": "20021130", "city": "Rio de Janeiro", "state": "RJ", "country": "BR", "status": "active", "created_at": "2023-04-14T18:13:16Z", "updated_at": "2023-04-14T18:13:16Z" }, "created_at": "2023-04-14T18:13:16Z", "updated_at": "2023-04-14T18:13:16Z", "phones": {} }, "last_transaction": { "id": "tran_BaQ7M70FRiQbVZew", "transaction_type": "debit_card", "gateway_id": "db376787-7071-49d4-9ab0-a3a5d4d176f2", "amount": 2990, "status": "captured", "success": true, "statement_descriptor": "AVENGERS", "acquirer_name": "stone", "acquirer_affiliation_code": "266B24CD5F429E56134743A01287BACB", "acquirer_tid": "20430073908801", "acquirer_nsu": "20430073908801", "acquirer_auth_code": "908801", "acquirer_message": "Stone|Aprovado", "acquirer_return_code": "0000", "operation_type": "capture", "network_token": { "id": "nt_doLl3pGmUrIo5Pgn", "first_six_digits": "525662", "last_four_digits": "5548", "brand": "Mastercard", "holder_name": "Tony Stark", "exp_month": 12, "exp_year": 2023, "created_at": "2023-04-14T18:13:16Z", "updated_at": "2023-04-14T18:13:16Z", "status": "active", "billing_address": { "street": "Malibu Point", "number": "10880", "zip_code": "90265", "neighborhood": "Central Malibu", "city": "Malibu", "state": "CA", "country": "US" } }, "payment_type": "Token", "created_at": "2023-04-14T18:13:25Z", "updated_at": "2023-04-14T18:13:25Z", "gateway_response": { "code": "201", "errors": [] }, "antifraud_response": {}, "metadata": {} }, } ] } ``` ```json Request cartão de débito utilizando Network Token com autenticação (Pedido) { "items": [ { "amount": 2990, "description": "Teste de débito", "quantity": 1, "code": "123" } ], "customer": { "name": "Tony Stark", "email": "tonystark@gmail.com", "document": "93095135270", "type": "individual", "document_type": "CPF", "address": { "line_1": "375, Av. General Justo, Centro", "line_2": "8º andar", "zip_code": "20021130", "city": "Rio de Janeiro", "state": "RJ", "country": "BR" } }, "payments": [ { "payment_method": "debit_card", "debit_card": { "capture": false, "installments": 1, "statement_descriptor": "AVENGERS", "network_token": { "number": "5256621004565548", "holder_name": "Tony Stark", "exp_month": 12, "exp_year": 2023, "cryptograms": [ "ANfQt43bddROAAEnSAMhAAADFA====" ], "billing_address": { "street": "Malibu Point", "number": "10880", "zip_code": "90265", "neighborhood": "Central Malibu", "city": "Malibu", "state": "CA", "country": "US" } }, "authentication": { "type": "threed_secure", "threed_secure": { "mpi": "acquirer", "success_url": "http://www.pagar.me" } } }, } ] } ``` ```json Response cartão de débito utilizando Network Token com autenticação (Pedido) { "id": "or_yJPVBm7szliRwx97", "code": "MKJDF40UO8", "amount": 2990, "currency": "BRL", "closed": true, "items": [ { "id": "oi_a9g8lb5t6cQKXWpe", "type": "product", "description": "Teste de débito", "amount": 2990, "quantity": 1, "status": "active", "created_at": "2023-04-14T18:25:38Z", "updated_at": "2023-04-14T18:25:38Z", "code": "123" } ], "customer": { "id": "cus_4qN8MKbCxt8aDovj", "name": "Tony Stark", "email": "TonyStark@gmail.com", "document": "93095135270", "document_type": "cpf", "type": "individual", "delinquent": false, "address": { "id": "addr_bve7jDhwvsm5orDk", "line_1": "375, Av. General Justo, Centro", "line_2": "8º andar", "zip_code": "20021130", "city": "Rio de Janeiro", "state": "RJ", "country": "BR", "status": "active", "created_at": "2023-04-14T18:13:16Z", "updated_at": "2023-04-14T18:13:16Z" }, "created_at": "2023-04-14T18:13:16Z", "updated_at": "2023-04-14T18:13:16Z", "phones": {} }, "status": "paid", "created_at": "2023-04-14T18:25:38Z", "updated_at": "2023-04-14T18:25:42Z", "closed_at": "2023-04-14T18:25:38Z", "charges": [ { "id": "ch_aRLoYxLHefrMOkAG", "code": "MKJDF40UO8", "gateway_id": "824a2f78-0548-4655-9131-8b4065066d77", "amount": 2990, "paid_amount": 2990, "status": "paid", "currency": "BRL", "payment_method": "debit_card", "paid_at": "2023-04-14T18:25:42Z", "created_at": "2023-04-14T18:25:39Z", "updated_at": "2023-04-14T18:25:42Z", "customer": { "id": "cus_4qN8MKbCxt8aDovj", "name": "Tony Stark", "email": "TonyStark@gmail.com", "document": "93095135270", "document_type": "cpf", "type": "individual", "delinquent": false, "address": { "id": "addr_bve7jDhwvsm5orDk", "line_1": "375, Av. General Justo, Centro", "line_2": "8º andar", "zip_code": "20021130", "city": "Rio de Janeiro", "state": "RJ", "country": "BR", "status": "active", "created_at": "2023-04-14T18:13:16Z", "updated_at": "2023-04-14T18:13:16Z" }, "created_at": "2023-04-14T18:13:16Z", "updated_at": "2023-04-14T18:13:16Z", "phones": {} }, "last_transaction": { "id": "tran_jRpOmqgckHn6NBEb", "transaction_type": "debit_card", "gateway_id": "5c7d44af-f695-4046-8264-fa7a238b3bae", "amount": 2990, "status": "captured", "success": true, "statement_descriptor": "AVENGERS", "acquirer_name": "stone", "acquirer_affiliation_code": "266B24CD5F429E56134743A01287BACB", "acquirer_tid": "20430073908837", "acquirer_nsu": "20430073908837", "acquirer_auth_code": "908837", "acquirer_message": "Stone|Aprovado", "acquirer_return_code": "0000", "operation_type": "capture", "mpi": "acquirer", "network_token": { "id": "nt_doLl3pGmUrIo5Pgn", "first_six_digits": "525662", "last_four_digits": "5548", "brand": "Mastercard", "holder_name": "Tony Stark", "exp_month": 12, "exp_year": 2023, "created_at": "2023-04-14T18:13:16Z", "updated_at": "2023-04-14T18:13:16Z", "status": "active", "billing_address": { "street": "Malibu Point", "number": "10880", "zip_code": "90265", "neighborhood": "Central Malibu", "city": "Malibu", "state": "CA", "country": "US" } }, "payment_type": "Token", "created_at": "2023-04-14T18:25:39Z", "updated_at": "2023-04-14T18:25:39Z", "gateway_response": { "code": "201", "errors": [] }, "antifraud_response": {}, "metadata": {} }, } } ] } ``` ## 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 |