# Wipei

# 1. Generar link de pago

El método devuelve un link que redirige al medio de pago.

POST /pagos

REQUEST

  • provider: (Tipo de dato: string). Nombre del Servicio de Pagos ("wipei"). Campo obligatorio.

  • action: (Tipo de dato: string). Tipo de acción a ejecutar ("create_order"). Campo obligatorio.

  • public_key: (Tipo de dato: string). Client id provisto por Wipei. Campo obligatorio.

  • secret: (Tipo de dato: string). Client secret provista por Wipei. Campo obligatorio.

  • reference_id: (Tipo de dato: string). Id de la orden. Campo obligatorio.

  • amount: (Tipo de dato: float). Monto total cobrar. Campo obligatorio.

  • return_url: (Tipo de dato: string). Url al la cual se desea retornar después de aprobado el pago. Campo obligatorio.

  • return_url_failure: (Tipo de dato: string). Url al la cual se desea retornar después en caso de rechazo de pago. Campo obligatorio.

  • notification_url: (Tipo de dato: string). Url al la cual se va a notificar el resultado de la transacción. Campo obligatorio.

  • items: (Tipo de dato: array). Array de los items de la orden. Incluir "name", "quantity" y "price". Campo obligatorio.

    • name: (tipo de dato: string). Nombre del producto.
    • quantity: (Tipo de dato: integer). Cantidad de unidades del producto.
    • price: (Tipo de dato: integer). Precio del producto.
{
    "provider": "wipei",
    "action": "create_order",
    "secret": "",
    "public_key": "",
    "amount": 1200,
    "reference_id": "5432", 
    "return_url": "http://store-url.com/wipei/success",
    "return_url_failure": "http://store-url.com/wipei/failure",
    "notification_url": "http://store-url.com/wipei/notify",
    "items": [
        {
            "name": "mesa",
            "quantity": 1,
            "price": 200
        }
    ]
}

RESPONSE

El método devuelve el link al que hay que redirigir al usuario para efectuar el pago.

{
    "init_point": "http://wipei.com.ar?order=25"
}

Nota. En caso de aprobado el pago, Wipei enviará una notificación al ecommerce por get enviando el id que se deberá consultar. (Entrará así: /wipei/notify?id=555). El siguiente paso será averiguar el estado de la orden.

# 1. Consultar pago

El método permite consultar el resultado de una transacción.

POST /pagos

REQUEST

  • provider: (Tipo de dato: string). Nombre del Servicio de Pagos ("wipei"). Campo obligatorio.

  • action: (Tipo de dato: string). Tipo de acción a ejecutar ("create_order"). Campo obligatorio.

  • public_key: (Tipo de dato: string). Client id provisto por Wipei. Campo obligatorio.

  • secret: (Tipo de dato: string). Client secret provista por Wipei. Campo obligatorio.

  • id: (Tipo de dato: string). Id de la orden de pago a consultar. Campo obligatorio.

{
    "provider": "wipei",
    "action": "get_order",
    "secret": "",
    "public_key": "",   
    "id": ""
}

RESPONSE

  • status: Devuelve el resultado de la transacción. Las opciones son "approved", "cancelled", "pending", "pending_approved", "pending_cancelled".

    • approved: El pago se completó correctamente.

    • cancelled: El pago se canceló o no finalizó en tiempo y forma.

    • pending: El pago está siendo gestionado.

    • pending_approved: El pago se completó correctamente, pero no se pudo enviar la notificación a la tienda. Este estado no debería llegar a una tienda.

    • pending_cancelled: El pago se canceló o no finalizó en tiempo y forma, pero no se pudo enviar la notificación a la tienda. Este estado no debería llegar a una tienda

{
    "id": "555",
    "seller_id": "123",
    "total": 500,
    "date": "2018-09-21T18:51:23.422Z",
    "status": "approved",
    "external_reference": "00025",
    "url_success": "http://store-url.com/wipei/success",
    "url_failure": "http://store-url.com/wipei/failure",
    "url_notify": "http://store-url.com/wipei/notify",
    "order_items": [
        {
            "id": "1",
            "order_id": "1",
            "name": "mesa",
            "quantity": 1,
            "price": 123
        }
    ]
}