O CardToken é o cartão tokenizado retornado ao salvar o cartão durante a autorização .
Este é um exemplo de como usar o CardToken já existente para criar uma transação.
- Por questões de segurança, um
CardTokennão armazena o Código de Segurança (CVV). Desta forma, é preciso solicitar esta informação ao portador para cada nova transação. - Para criar transações recorrentes (que permitem transacionar sem utilizar o CVV), entre em contato com o nosso Suporte.
O nó CreditCard dentro do nó Payment será alterado conforme exemplo a seguir:
Requisição
| Ambiente | Método | Endpoint |
|---|---|---|
| Sandbox | post | https://apisandbox.braspag.com.br/v2/sales/ |
| Produção | post | https://api.braspag.com.br/v2/sales/ |
{
"MerchantOrderId": "2017051001",
"Customer": {
"Name": "Aline de Souza",
"Identity": "12345678900",
"IdentityType": "CPF",
"Email": "[email protected]",
"Birthdate": "1990-01-01",
"IpAddress": "127.0.0.1",
"Address": {
"Street": "Rua das Rosas",
"Number": "123",
"Complement": "Apartamento 101",
"ZipCode": "12345987",
"City": "São Paulo",
"State": "SP",
"Country": "BR",
"District": "Centro"
},
"DeliveryAddress": {
"Street": "Rua das Rosas",
"Number": "123",
"Complement": "Apartamento 101",
"ZipCode": "12345987",
"City": "São Paulo",
"State": "SP",
"Country": "BR",
"District": "Centro"
}
},
"Payment": {
"Provider": "Simulado",
"Type": "CreditCard",
"DoSplit": true,
"Amount": 10000,
"Currency": "BRL",
"Country": "BRA",
"Installments": 1,
"Capture": true,
"Authenticate": false,
"Recurrent": false,
"SoftDescriptor": "Mensagem",
"CreditCard": {
"CardToken": "1be20054-7042-4e7d-a154-bb413c911597",
"SecurityCode": "123",
"Brand": "Visa"
},
"InitiatedTransactionIndicator": {
"Category": "C1",
"Subcategory": "Standingorder"
},
"SplitPayments": [
{
"SubordinateMerchantId": "f2d6eb34-2c6b-4948-8fff-51facdd2a28f",
"Amount": 5000,
"Fares": {
"Mdr": 5,
"Fee": 30
}
},
{
"SubordinateMerchantId": "9140ca78-39667-44a5-bd44-793370afef94",
"Amount": 5000,
"Fares": {
"Mdr": 4,
"Fee": 15
}
}
]
}
}
| Propriedade | Descrição | Tipo | Tamanho | Obrigatório? |
|---|---|---|---|---|
Payment.Provider | Nome do provedor do meio de pagamento. | Texto | 15 | Sim |
Payment.Type | Tipo do meio de pagamento. | Texto | 100 | Sim |
Payment.Amount | Valor do pedido, em centavos. | Número | 15 | Sim |
Payment.Installments | Número de parcelas. | Número | 2 | Sim |
CreditCard.CardToken | Token no Cartão Protegido que representa os dados do cartão. | GUID | 36 | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
CreditCard.SecurityCode | Código de segurança impresso no verso do cartão. Para processar vendas sem o CVV, é necessário solicitar liberação na adquirente. | Texto | 4 | Não |
CreditCard.Brand | Bandeira do cartão. | Texto | 10 | Sim |
InitiatedTransactionIndicator.Category | Obrigatório para bandeira Mastercard. Categoria do indicador de início da transação. Válido apenas para bandeira Mastercard. Valores possíveis: - “C1”: transação inciada pelo portador do cartão; - “M1”: transação recorrente ou parcelada iniciada pela loja; - “M2”: transação iniciada pela loja. | Texto | 2 | Não |
InitiatedTransactionIndicator.Subcategory | Obrigatório para bandeira Mastercard. Subcategoria do indicador. Válido apenas para bandeira Mastercard. Valores possíveis: Se InitiatedTransactionIndicator.Category = "C1" ou "M1"CredentialsOnFile StandingOrder Subscription Installment Se InitiatedTransactionIndicator.Category = "M2"PartialShipment RelatedOrDelayedCharge NoShow Resubmission Consulte a tabela com a descrição das subcategorias em <a href="https://docs.cielo.com.br/gateway/page/cit-mit" target="_blank">Indicador de Início da Transação</a>. | Texto | -- | Não |
Resposta
{
[...]
},
"Payment": {
"Provider": "Simulado",
"Type": "CreditCard",
"Amount": 10000,
"Currency": "BRL",
"Country": "BRA",
"Installments": 1,
"Capture": true,
"Authenticate": false,
"Recurrent": false,
"SoftDescriptor": "Mensagem",
"CreditCard": {
"CardToken":"250e7c7c-5501-4a7c-aa42-a33d7ad61167",
"SecurityCode":"123",
"Brand":"Visa"
},
"ProofOfSale": "124305",
"AcquirerTransactionId": "0511030124305",
"AuthorizationCode": "065964",
"PaymentId": "23cd8bf5-2251-4991-9042-533ff5608788",
"Type": "CreditCard",
"Amount": 10000,
"ReceivedDate": "2017-05-11 15:01:24",
"Currency": "BRL",
"Country": "BRA",
"Provider": "Simulado",
"ReasonCode": 0,
"ReasonMessage": "Successful",
"Status": 1,
"ProviderReturnCode": "4",
"ProviderReturnMessage": "Operation Successful",
[...]
}
}| Propriedade | Descrição | Tipo | Tamanho | Formato |
|---|---|---|---|---|
AcquirerTransactionId | Id da transação no provedor de meio de pagamento. | Texto | 40 | Texto alfanumérico |
ProofOfSale | Número do comprovante de venda. | Texto | 20 | Texto alfanumérico |
AuthorizationCode | Código de autorização. | Texto | 300 | Texto alfanumérico |
PaymentId | Campo identificador do pedido. | GUID | 36 | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
ReceivedDate | Data em que a transação foi recebida pelo Split. | Texto | 19 | AAAA-MM-DD HH:mm:SS |
ReasonCode | Código de retorno da operação. | Texto | 32 | Texto alfanumérico |
ReasonMessage | Mensagem de retorno da operação. | Texto | 512 | Texto alfanumérico |
Status | Status da transação. | Byte | 2 | Ex.: 1 |
ProviderReturnCode | Código retornado pelo provedor do meio de pagamento (adquirente ou emissor). | Texto | 32 | 57 |
ProviderReturnMessage | Mensagem retornada pelo provedor do meio de pagamento (adquirente ou emissor). | Texto | 512 | Transação Aprovada |