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 camposmpi
eredirect_url
. Os camposmpi
,eci
,cavv
etransaction_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",
"funding_source": "prepaid",
"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 |