🔗Nova venda via cartão de crédito com cliente já definido

Nova venda via cartão de crédito com cliente já definido:

Para uma nova venda via cartão de crédito com cliente já definido é 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
tipoPagamentoId		1 = Boleto 2 = Débito(Não implementado) 3 = Cartão de crédito
clienteId		Identificador do cliente já cadastrado
valor		Valor total da nova venda
parcelas		Quantidade de parcelas da compra no cartão
titular		Nome do titular do cartão
numero		Número do cartão
codigoSeguranca		Código de Segurança ou CVV do cartão
validade		Mês e ano em que o cartão expira sua validade
logradouro		Rua ou avenida do endereço
numero		Número do endereço
cep		Código postal do endereço
cidade		Cidade do endereço
estado		Código ISO 3166-2 para o estado, com duas letras
complemento		Complemento do endereço
ip		Identificador da rede ou dispositivo

Exemplo de requisição:

{
  "tipoPagamentoId": 3,
  "clienteId": 5648913,
  "splits": [

  ],
  "valor": 640,
  "parcelas": 8,
  "cartao": {
    "titular": "moacir berere",
    "numero": "36299109484952",
    "codigoSeguranca": "654",
    "validade": "07/2021"
  },
  "ip": "201.27.139.162"
}

Exemplo de resultado:

{
    "success": true,
    "pedido": {
      "id": 7901715,
      "parent_id": null,
      "tipo_pedido_id": 1,
      "usuario_id": 125,
      "cliente_id": 5648913,
      "estabelecimento_id": 158,
      "marketplace_id": null,
      "status_pedido_id": 2,
      "cliente_cartao_id": 5688515,
      "pos_identification_number": null,
      "valor_bruto": "640.00",
      "valor_liquido": "0.00",
      "tipo_pagamento": null,
      "bandeira": null,
      "parcelas": 8,
      "markup": null,
      "capture_mode": null,
      "splitted": 0,
      "oculto": 0,
      "splitted_link": 0,
      "taxed": 0,
      "antecipado": 0,
      "referencia": "",
      "msg_erro": null,
      "created": "2021-02-11T19:46:33.000Z",
      "modified": "2021-02-11T19:46:38.000Z",
      "removed": null,
      "cartaoId": 5688515
    }
  }

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."
}