🔗Nova venda via cartão de crédito

Nova venda via cartão de crédito:

Para uma nova venda via cartão de credito é necessário seguir este roteiro de detalhe. O procedimento requer o envio de uma solicitação utilizando o método POST.

Esta solicitação pode ser realizada de duas maneiras distintas: utilizando dados no formato JSON ou através de Multipart/fomr-data.

URL de Solicitação:

https://api.zsystems.com.br/vendas

Cabeçalhos Exigidos para a Requisição:

• Content-Type: Necessário especificar como multipart/form-data ou application/json, adaptado ao método de envio dos dados.

• Authorization: Precisa incluir um 'TokenAPI', precedido por Bearer, para confirmar a autenticação e conceder permissão para realizar a solicitação.

Detalhes dos Parâmetros da Solicitação:

Id	Tipo	Descrição
codigoSeguranca		Código de Segurança ou CVV do cartão
numero		Número do cartão
titular		Nome do titular do cartão
validade		Mês e ano em que o cartão expira sua validade
celular		Número celular do cliente
cpf		CPF do cliente
dataNascimento		Data de nascimento do cliente
email		E-mail do cliente
nome		Nome do cliente
cep		Código postal do endereço
cidade		Cidade do endereço
complemento		Complemento do endereço
estado		Código ISO 3166-2 para o estado, com duas letras
logradouro		Rua ou Avenida do endereço
numero		Número do endereço
ip		Identificador da rede ou dispositivo
parcelas		Quantidade de parcelas da compra no cartão
tipoPagamentoId		1 = Boleto 2 = Débito(Não implementado) 3 = Cartão de crédito
valor		Valor total da nova venda

Exemplo de requisição:

{
  "cartao": {
    "codigoSeguranca": "270",
    "numero": "5216649341292186",
    "titular": "Alduir Geronimo",
    "validade": "05/2022"
},
  "cliente": {
    "celular": "12090190912",
    "cpf": "54311325045",
    "dataNascimento": "1999-09-10",
    "email": "[e-mail]",
    "nome": "Alduir Geronimo"
},
  "endereco": {
    "cep": "02912-000",
    "cidade": "São Paulo",
    "complemento": "Perto do posto Petrobrás",
    "estado": "SP",
    "logradouro": "Rua Coronel Bento Bicudo",
    "numero": "847"
},
  "ip": "201.27.139.162",
  "parcelas": 5,
  "splits": [
	 
    ],
  "tipoPagamentoId": 3,
  "valor": 850
}

Exemplo de resultado:

{
    "success": true,
    "pedido": {
      "id": 7901439,
      "parent_id": null,
      "tipo_pedido_id": 1,
      "usuario_id": 125,
      "cliente_id": 5725186,
      "estabelecimento_id": 158,
      "marketplace_id": null,
      "status_pedido_id": 2,
      "cliente_cartao_id": 5688319,
      "pos_identification_number": null,
      "valor_bruto": "850.00",
      "valor_liquido": "0.00",
      "tipo_pagamento": null,
      "bandeira": null,
      "parcelas": 5,
      "markup": null,
      "capture_mode": null,
      "splitted": 0,
      "oculto": 0,
      "splitted_link": 0,
      "taxed": 0,
      "antecipado": 0,
      "referencia": "",
      "msg_erro": null,
      "created": "2021-02-11T19:32:40.000Z",
      "modified": "2021-02-11T19:32:44.000Z",
      "removed": null,
      "cartaoId": 5688319
    }
  }

Exemplo de erro:

{
  "success": false,
  "error": {
    "type": "card_error",
    "category": "card_declined",
    "message": "Transação não autorizada. Para
    mais informações, entre em contato com seu banco."
  },
  "message": "Transação não autorizada. Para
  mais informações, entre em contato com seu banco."
}