Venda Simples
Abaixo segue um exemplo de transação enviado, somente com os parâmetros obrigatórios que são Valor e o Produto.
{
"Amount": 1500,
"Product": 1
}
Exemplo de uma venda no de R$ 15,00 no crédito.
Venda Completo Parcelado Emissor
Nesse exemplo já é passado as informações da venda como produto(Crédito e Débito), tipo de parcelamento(à vista, parcelado emissor, parcelado pelo estabelecimento e outros) e número de parcelas(quantidade parcelas), não solicitando essa informações no momento da transação.
{
"Amount" : 15000,
"Product" : 1,
"FinType" : 2,
"Installments" : 3
}
Exemplo de venda no valor de R$150,00 no crédito parcelado pelo emissor do cartão em 3x.
Venda Completo Parcelado Estabelecimento
Nesse exemplo já é passado as informações da venda como produto(Crédito e Débito), tipo de parcelamento(à vista, parcelado emissor, parcelado pelo estabelecimento e outros) e número de parcelas(quantidade parcelas), não solicitando essa informações no momento da transação.
{
"Amount" : 15000,
"Product" : 1,
"FinType" : 4,
"Installments" : 2
}
Exemplo de venda no valor de R$150,00 no crédito parcelado pelo estabelecimento em 2x
Venda Digitada (Crédito) Simples
A venda digitada é utilizada quando não se tem o cartão presente, é uma venda não presencial, nesses casos deve ser passado CardFullPan número do cartão.
É necessário sempre checar se adquirente possui esse produto habilitado.
{
"Amount" : 1500,
"Product" : 6,
"CardFullPan" : "9999999999999999"
}
Exemplo de venda digitada no valor de R$15,00.
Venda Digitada (Crédito) Completo
Exemplo de uma venda digitada passando as informações de produto, tipo de parcelamento e quantidade de parcelas.
{
"Amount" : 1500,
"Product" : 6,
"CardFullPan" : "9999999999999999",
"FinType" : "04",
"Installments" : "2"
}
Exemplo de venda digitada no valor de R$15,00 parcelado estabelecimento em 2x.
Venda Multi TEF (Pagamento com dois ou mais cartões).
O fluxo do Multi TEF é uma opção de pagamento com vários cartões. Caso, seja feita a opção Multi Cartões, o primeiro JSON será enviado com duas propriedades: Amount e MultiCard. Após, será seguido o fluxo de Venda conforme as vendas citadas nos exemplos abaixo.
{
"Amount" : 1500,
"MultiCard" : 1
}
Exemplo de uma chamada de Múltiplos Cartões no valor de R$ 15,00
Venda PIX
Para esse processo de venda funcionar é necessário que a opção de pix esteja ativa.
Abaixo segue um exemplo deste tipo de transação enviada, somente com os parâmetros obrigatórios que são Valor e o Produto.
{
"Amount": 1500,
"Product": 98
}
Exemplo de uma venda no Pix de R$ 15,00.
Repostas de Vendas
Abaixo segue todos os exemplos de vendas com sucesso e negadas.
Parâmetros da Reposta de venda com Sucesso
| # | Campo | Valor | Descrição | Observação |
|---|---|---|---|---|
| 1 | Amount | string | Valor da transação | Será retornado valores sem vírgula, será considerado os 2 últimos dígitos como casa decimal (exemplo: 2354 = 23,54) |
| 2 | AppDate | string | data da transação no aplicativo | Exemplo: 0001-01-01T00:00:00 |
| 3 | AuthorizationCode | string | - | Código de autorização da transação |
| 4 | AuthorizationDate | string | data de autorização da transação no formato: yyyyMMddHHmmss | Exemplo: 20190611171903 |
| 5 | AuthorizerName | string | Nome Autorizadora de Pagamento | Exemplo: Justa, Rede, PagSeguro ou Outros. |
| 6 | AuthorizerResponseCode | Integer | Código de autorização da transação | Qualquer valor acima de zero indica falha na operação, como transação negada, senha incorreta entre outros... |
| 7 | AuthorizerUniqueIdentifier | string | Código único de identificação de transação dentro da adquirente | Exemplo: 10755 |
| 8 | CardName | string | - | Nome da Operadora do cartão |
| 9 | CustomerReceipt | string | Recibo do cliente | Este campo retorna o recibo da transação como via do cliente |
| 10 | FinType | 0,1,2,4,8 ou 16 | Tipo de Financiamento (Obs: Esse retorno só é preenchido caso a venda seja diferente de "À Vista") | 0 = Pix, 1 = à vista, 2 = parcelado pelo emissor, 4 = parcelado pelo estabelecimento, 8 = pré-datado e 16 = CDC\crediário |
| 11 | Installments | 2,3,4... | Quantidade de parcelas | Valor "Inteiro" maior que "1" informado apenas para vendas parceladas, indicando o número de parcelas |
| 12 | MaskedCardNumber | string | Número do cartão utilizado na venda truncado pela adquirente | O retorno deste campo é de responsabilidade da adquirente envolvida na transação |
| 13 | PWUniqueIdentifier | string | Código único de identificação de transação dentro da estrutura de gestão das adquirentes | Exemplo: 966399 |
| 14 | PreDate | string | data de Pré-Autorização da transação no formato: yyyyMMddHHmmss | Exemplo: 20190611171903 |
| 15 | Product | 1,2,4,6,8 ou 98 | Tipos de cartão (pagamento) aceito nas transações | 1 = Crédito, 2 = Débito, 4 = Voucher, 6 = Venda digitada (Crédito), 8 = Outros ou 98 = Pix |
| 16 | ReducedReceipt | string | Recibo reduzido | Este campo retorna o recibo da transação no formato reduzido |
| 17 | RemainingAmount | string | O valor restante de uma transação Multi Tef | 500 |
| 18 | RetailerReceipt | string | Recibo do Lojista | Este campo retorna o recibo da transação como via do Lojista |
| 19 | SingleReceipt | string | Recibo do Estabelecimento | Este campo retorna uma via única do recibo utilizado tanto para o Estabelecimento ou Cliente |
| 20 | TotalPayments | int | Este campo retorna a quantidade de pagamentos feitos na opção Multi Tef | Quantidade de Pagamentos: 3 |
| 21 | TransactionRetailerCode | string | Código único de identificação de transação dentro da Justa | Exemplo: 3443 |
| 22 | TransactionStatus | string | - | Status da transação Ex.: TRANSACAO AUTORIZADA |
Reposta de Venda com Sucesso
{
"justa_transaction": {
"Amount": "1500",
"AppDate": "0001-01-01T00:00:00",
"AuthorizationCode": "094787",
"AuthorizationDate": "20190801155438",
"AuthorizerName": "JUSTA",
"AuthorizerResponseCode": 0,
"AuthorizerUniqueIdentifier": "10755",
"CardName": "MASTERCARD CREDITO",
"CustomerReceipt": " JUSTA SOLUCOES FINANCEIRAS\r\n 07.383.312/0001-70\r\n\r\nVIA CLIENTE\r\n\r\n JUSTA\r\n CREDITO \r\n MASTERCARD CREDITO\r\n ************4026\r\nJC: 3443\r\n11/06/2019 17:19:03\r\nDOC:000010755 AUT:094787\r\nVALOR: R$15,00\r\n JUSTA\r\n",
"FinType": "01",
"Installments": "1",
"MaskedCardNumber": "************4026",
"PWUniqueIdentifier": "966399",
"PreDate": null,
"Product": 1,
"ReducedReceipt": "MASTERCARD CREDITO 1x ************4026\r\nJC: 3443\r\nDOC: 000010755 AUTORIZ: 094787\r\nVLR: R$15,00\r\nJUSTA\r\n",
"RemainingAmount": "",
"RetailerReceipt": " JUSTA SOLUCOES FINANCEIRAS\r\n 07.383.312/0001-70\r\n\r\nVIA ESTABELEC.\r\n\r\n JUSTA\r\n CREDITO \r\n MASTERCARD CREDITO\r\n ************4026\r\nJC: 3443\r\n11/06/2019 17:19:03\r\nDOC:000010755 AUT:094787\r\nVALOR: R$15,00\r\n JUSTA\r\n",
"SingleReceipt": " JUSTA SOLUCOES FINANCEIRAS\r\n 07.383.312/0001-70\r\n\r\n JUSTA\r\n CREDITO \r\n MASTERCARD CREDITO\r\n ************4026\r\nJC: 3443\r\n11/06/2019 17:19:03\r\nDOC:000010755 AUT:094787\r\nVALOR: R$15,00\r\n JUSTA\r\n",
"TransactionStatus": "TRANSACAO AUTORIZADA",
"TotalPayments": null,
"TransactionRetailerCode": "3443"
}
}
Resposta Venda com Falha
{
"transaction_error" : "Valor informado é maior que multiplos cartões!",
}
Exemplo de response com falha, por informar o valor do múltiplos cartões maior que o valor restante da venda
Reposta de Multi TEF com Sucesso.
No caso de Multi TEF é retornado Array de comprovantes da venda, com cada pagamento confirmado.
{
"multiCardTransactions": [
{
"Amount": "1500",
"AppDate": "0001-01-01T00:00:00",
"AuthorizationCode": "094787",
"AuthorizationDate": "20190801155438",
"AuthorizerName": "JUSTA",
"AuthorizerResponseCode": 0,
"AuthorizerUniqueIdentifier": "10755",
"CardName": "MASTERCARD CREDITO",
"CustomerReceipt": " JUSTA SOLUCOES FINANCEIRAS\r\n 07.383.312/0001-70\r\n\r\nVIA CLIENTE\r\n\r\n JUSTA\r\n CREDITO \r\n MASTERCARD CREDITO\r\n ************4026\r\nJC: 3443\r\n11/06/2019 17:19:03\r\nDOC:000010755 AUT:094787\r\nVALOR: R$15,00\r\n JUSTA\r\n",
"FinType": "01",
"Installments": "1",
"MaskedCardNumber": "************4026",
"PWUniqueIdentifier": "966399",
"PreDate": null,
"Product": 1,
"ReducedReceipt": "MASTERCARD CREDITO 1x ************4026\r\nJC: 3443\r\nDOC: 000010755 AUTORIZ: 094787\r\nVLR: R$15,00\r\nJUSTA\r\n",
"RemainingAmount": "500",
"RetailerReceipt": " JUSTA SOLUCOES FINANCEIRAS\r\n 07.383.312/0001-70\r\n\r\nVIA ESTABELEC.\r\n\r\n JUSTA\r\n CREDITO \r\n MASTERCARD CREDITO\r\n ************4026\r\nJC: 3443\r\n11/06/2019 17:19:03\r\nDOC:000010755 AUT:094787\r\nVALOR: R$15,00\r\n JUSTA\r\n",
"SingleReceipt": " JUSTA SOLUCOES FINANCEIRAS\r\n 07.383.312/0001-70\r\n\r\n JUSTA\r\n CREDITO \r\n MASTERCARD CREDITO\r\n ************4026\r\nJC: 3443\r\n11/06/2019 17:19:03\r\nDOC:000010755 AUT:094787\r\nVALOR: R$15,00\r\n JUSTA\r\n",
"TransactionStatus": "TRANSACAO AUTORIZADA",
"TotalPayments": 1,
"TransactionRetailerCode": "3443"
},
{
"Amount": "1500",
"AppDate": "0001-01-01T00:00:00",
"AuthorizationCode": "094787",
"AuthorizationDate": "20190801155438",
"AuthorizerName": "JUSTA",
"AuthorizerResponseCode": 0,
"AuthorizerUniqueIdentifier": "10755",
"CardName": "MASTERCARD CREDITO",
"CustomerReceipt": " JUSTA SOLUCOES FINANCEIRAS\r\n 07.383.312/0001-70\r\n\r\nVIA CLIENTE\r\n\r\n JUSTA\r\n CREDITO \r\n MASTERCARD CREDITO\r\n ************4026\r\nJC: 3443\r\n11/06/2019 17:19:03\r\nDOC:000010755 AUT:094787\r\nVALOR: R$15,00\r\n JUSTA\r\n",
"FinType": "01",
"Installments": "1",
"MaskedCardNumber": "************4026",
"PWUniqueIdentifier": "966399",
"PreDate": null,
"Product": 1,
"ReducedReceipt": "MASTERCARD CREDITO 1x ************4026\r\nJC: 3443\r\nDOC: 000010755 AUTORIZ: 094787\r\nVLR: R$15,00\r\nJUSTA\r\n",
"RemainingAmount": "0",
"RetailerReceipt": " JUSTA SOLUCOES FINANCEIRAS\r\n 07.383.312/0001-70\r\n\r\nVIA ESTABELEC.\r\n\r\n JUSTA\r\n CREDITO \r\n MASTERCARD CREDITO\r\n ************4026\r\nJC: 3443\r\n11/06/2019 17:19:03\r\nDOC:000010755 AUT:094787\r\nVALOR: R$15,00\r\n JUSTA\r\n",
"SingleReceipt": " JUSTA SOLUCOES FINANCEIRAS\r\n 07.383.312/0001-70\r\n\r\n JUSTA\r\n CREDITO \r\n MASTERCARD CREDITO\r\n ************4026\r\nJC: 3443\r\n11/06/2019 17:19:03\r\nDOC:000010755 AUT:094787\r\nVALOR: R$15,00\r\n JUSTA\r\n",
"TransactionStatus": "TRANSACAO AUTORIZADA",
"TotalPayments": 2,
"TransactionRetailerCode": "3443"
}
]
}