# Konduto

# 1. Obtener orden

POST /PAGOS

El método permite averiguar si una orden existe, es decir, si alguna vez fue informada a Konduto.

REQUEST

provider: (Tipo de dato: string). Konduto. Campo obligatorio.
action: (Tipo de dato: string). "get_order". Campo obligatorio.
order_id: (Tipo de dato: string). Id de la orden. Está formada por el número de la orden en Hermés y los últimos cuatro números de la tarjeta separados por guión. (Ejemplo: "6543-1234") Campo obligatorio.
api_key: (Tipo de dato: string). Llave privada provista por Konduto al cliente. Campo obligatorio.

{
    "provider": "konduto",
    "action": "get_order",
    "order_id": "6543-1234",
    "api_key": "T21335EB23B4EA7B44725"
}

RESPONSE

Si la orden no existe devuelve "null" y si la orden existe devuelve la información de la orden informada oportunamente.

{
    order: {
    shopping_cart: [ [Object] ],
    analysis_layers: [ [Object] ],
    created_at: '2023-07-05T13:02:57Z',
    recommendation: 'approve',
    billing: {
      zip: '1407',
      country: 'AR',
      city: 'Villa Luro',
      address1: 'Cortina 120',
      name: 'Andrés Jaromezuk',
      state: 'CABA'
    },
    shipping_amount: 150,
    score: 0,
    updated_at: '2023-07-05T13:02:57Z',
    shipping: {
      zip: '1407',
      country: 'AR',
      city: 'Villa Luro',
      address1: 'Cortina 120',
      name: 'Andrés Jaromezuk',
      state: 'CABA'
    },
    total_amount: 5050,
    currency: 'ARS',
    payment: [ [Object] ],
    id: '6587-1234',
    status: 'approved',
    customer: {
      name: 'Andrés Jaromezuk',
      id: 'andres.jaromezuk@pow.la',
      tax_id: '299466689',
      email: 'andres.jaromezuk@pow.la',
      phone1: '1147489321'
    }
  },
  status: 'ok'
}

# 2. Chequear pago

POST /PAGOS

El método procesa el antifraude y devuelve APPROVE, REVIEW, o DECLINE.

REQUEST

provider: (Tipo de dato: string). Konduto. Campo obligatorio.
action: (Tipo de dato: string). "check". Campo obligatorio.
api_key: (Tipo de dato: string). Llave privada provista por Konduto al cliente. Campo obligatorio.
order.id: (Tipo de dato: string). Id de la orden. Está formada por el número de la orden en Hermés y los últimos cuatro números de la tarjeta separados por guión. (Ejemplo: "6543-1234") Campo obligatorio.
order.visitor: (Tipo de dato: string). Id del visitante. Se obtiene a partir de un script de konduto implementado en el e-commerce. Campo obligatorio.
order.total_amount: (Tipo de dato: string). Monto total de la orden. Campo obligatorio.
order.shipping_amount: (Tipo de dato: string). Costo del envío. Campo obligatorio.
order.currency: (Tipo de dato: string). Tipo de moneda. Campo obligatorio.
customer.id: (Tipo de dato: string). Email del comprador. Campo obligatorio.
customer.name: (Tipo de dato: string). Nombre del comprador. Campo obligatorio.
customer.phone1: (Tipo de dato: string). Teléfono del comprador. Campo obligatorio.
customer.email: (Tipo de dato: string). Email del comprador. Campo obligatorio.
customer.tax_id: (Tipo de dato: string). Número de documento. Campo obligatorio.
payment.type: (Tipo de dato: string). Forma de pago. Valores posibles: "credit", "boleto", "debit", "transfer", "voucher" o "balance". Campo obligatorio.
payment.bin: (Tipo de dato: string). Primeros 6 números de la tarjeta. Campo obligatorio.
payment.last4: (Tipo de dato: string). Últimos 4 números de la tarjeta. Campo obligatorio.
payment.expiration_date: (Tipo de dato: string). Fecha de vencimiento de la tarjeta. Informar número de 6 cifras, para meses menores a 10 agregar 0 delante si hace falta. (Ejemplo: agosto 2027 -> 082027) Campo obligatorio.
payment.status: (Tipo de dato: string). Status del pago. Enviar "pending". Campo obligatorio.
address.name: (Tipo de dato: string). Nombre que figura en la dirección de facturación. Campo obligatorio.
address.address1: (Tipo de dato: string).Calle y numero de la dirección de facturación. Campo obligatorio.
address.city: (Tipo de dato: string). Ciudad de la dirección de facturación. Campo obligatorio.
address.state: (Tipo de dato: string). Provincia/departament/estado de la dirección de facturación. Campo obligatorio.
address.zip: (Tipo de dato: string). Código postal de la dirección de facturación. Campo obligatorio.
address.country: (Tipo de dato: string). País de la dirección de facturación. Campo obligatorio.
ship_cart: Array de productos de la orden.
- product_code: (Tipo de dato: string). Id del producto. Campo obligatorio.
- name: (Tipo de dato: string). Nombre del producto. Campo obligatorio.
- quantity: (Tipo de dato: string). Cantidad comprada del producto. Campo obligatorio.
- sku: (Tipo de dato: string). Sku del producto. Campo obligatorio.

{
    "provider": "konduto",
    "action": "check",
    "api_key": "T21335EB23B4EA7B44725",
    "order":{
        "id": "6588-1234",
        "visitor": "1111",
        "total_amount": "5050.0",
        "shipping_amount": "150.0",
        "currency": "ARS"
    },
    "customer": {
        "id": "andres.jaromezuk@pow.la",
        "name": "Andrés Jaromezuk",
        "phone1": "1147489321",
        "email": "andres.jaromezuk@pow.la",
        "tax_id": "299466689"
    },
    "payment": {
        "type": "credit",
        "bin": "490172",
        "last4": "1234",
        "expiration_date": "082026",
        "status": "pending"
    },
    "address":{
        "name": "Andrés Jaromezuk",
        "address1": "Cortina 120",
        "city": "Villa Luro",
        "state": "CABA",
        "zip": "1407",
        "country": "AR"
    },
    "ship_cart":[
        {
            "product_code": "7",
            "name": "Zapatillas",
            "quantity": 1,
            "sku": "aaa2345"
        }
    ]
}

RESPONSE

order.recommendation: Resultadao del análisis. Puede ser APPROVE, REVIEW, o DECLINE.

Respuesta: {
  status: 'ok',
  order: {
    id: '10000000001',
    score: 0,
    ip: '189.68.156.100',
    recommendation: 'APPROVE',
    status: 'approved',
    geolocation: { city: 'São Paulo', state: 'São Paulo', country: 'BR' },
    analysis_layers: [ [Object] ]
  }
}