Pedido com Cash

O fluxo de fechamento de pedido em pontos pode ser utilizado para fechar pedidos também em cash do lado do fornecedor. Porém, o fornecedor deverá disponibilizar uma rota com opções de parcelamento e o objeto payment na rota de fechamento deverá será preenchido com o pagamento escolhido pelo usuário.

Para o fechamento do pedido a mesma rota pode ser usada porém o request deve ser acrescido do objeto com os dados para pagamento.

Adotamos a seguinte nomenclatura para bandeiras de cartão:

PaymentId - Cartão/Bandeira
2- MasterCard
3- Visa
4- Diners
5- American Express
6- Aura
7- Hipercard
8- Elo

A resposta deve conter também um objeto que indique a ocorrência de erros, com os dados necessários para o entendimento do tipo e dos detalhes do erro ocorrido.

Nota: Valores monetários devem sempre ser em formato inteiro com os algarismos menos significativos representando os centavos.

Detalhes técnicos do endpoint para opções de pagamento

Método: GET

Rota

https://address.domain/api/paymentoptions?value=1701

Nota: Para as descrições de pagamento retornar no seguinte formato: 

"À vista"
"2X sem juros"
"3X sem juros"
"5X com juros"

Request em caso de sucesso

{
   "paymentOptions": [{
     "paymentId": 2,
     "installmentOptions": [
      {
        "description": "À vista",
        "parcels": 1,
        "value": 1701
      },
      {
       "description": "2X sem juros",
       "parcels": 2,
       "value": 945
      },
      {
        "description": "3X sem juros",
        "parcels": 3,
        "value": 630
      }
    ]
},
{
   "paymentId": 3,
   "installmentOptions": [
   {
      "description": "À vista",
      "parcels": 1,
      "value": 1701
   },
   {
      "description": "2X sem juros",
      "parcels": 2,
      "value": 945
   },
   {
      "description": "3X sem juros",
      "parcels": 3,
      "value": 630
    }
   ]
 }
]
}

Detalhes técnicos do endpoint para fechamento de pedido Cash

Método: POST

Rota

https://address.domain/api/order

Request para cash (incluído objeto de pagamento)

{
 "order": {
    "id": 12021,
    "createDate": "2017-01-20T18:42:50.2113215-02:00",
    "shipping": {
      "costPrice": 1000,
      "deliveryForecast": "2017-02-02T00:00:00.0000000T-02:00",
      "receiver": {
        "name": "Jesse Oliveira",
        "cpfCnpj": "33655521201",
        "email": "jesselemos@gmail.com",
        "birthDate": "1985-05-29T00:00:00.0000000-02:00",
        "personType": 1,
        "genderType": 1,
        "phones": [
          {
            "DDD": "11",
            "number": "965112254",
            "type": 3
          }
        ]
      },
      "shippingAddress": {
        "address": "rua joao ferreira, 25",
        "number": "283",
        "complement": "Casa 2",
        "city": "Barueri",
        "district": "",
        "state": "SP",
        "zipCode": "06253220",
        "reference": "Casa verde"
      }
    },
    "participant": {
      "name": "Jesse Oliveira",
      "cpfCnpj": "36077266855",
      "email": "jesselemos@gmail.com",
      "birthDate": "1985-05-29T00:00:00.0000000-02:00",      
"pesronType": 1,
      "genderType": 1,
      "phones": [
        {
          "DDD": "11",
          "number": "965112254",
          "type": 3
        }
      ]
    },
    "items": [
      {
        "sku": "32155",
        "name": "Nome do Produto",
        "quantity": 2,
        "costPrice": 1000
      }
    ],
    "amount": 2000
  },
  "payment": {
       "paymentId": 1,
       "parcels": 10,
       "ownerDocument": "046044854888",
       "cardNumber": "4444444444444444",
       "expirationMonth": "01",
       "expirationYear": "2020",
       "ownerName": "Owner Name",
       "securityCode": "001"
      }
}

Response em caso de sucesso

Status Code: 200

{
     "orderId": 12021,
     "orderVendorId": "321654",
     "error": null
}

Response em caso de erro

Status Code: 200 ou outro

{
   "orderId": null,
   "orderVendorId": null,
   "error": {
      "code": 1002,
      "message": "Ocorreu um erro ao consultar a base de CEP"
   }
}