# GoCuotas

# 1. Procesar pago

POST /pagos

Se utiliza para procesar un pago.

REQUEST

provider: (Tipo de dato: string). Nombre del proveedor del servicio (govuotas). Campo obligatorio.
action: (Tipo de dato: string). Identificador de la acción a procesar (create). Campo obligatorio.
email: (Tipo de dato: string). Email de gocuotas de la marca. Campo obligatorio.
password: (Tipo de dato: string). Password de la marca provisto por gocuotas.Campo obligatorio.
payer_email: (Tipo de dato: string). Email del comprador. Campo obligatorio.
amount:(Tipo de dato: string). Monto a cobrar. Campo obligatorio.
reference_id: (Tipo de dato: string). Id de la orden. Campo obligatorio.
return_url: (Tipo de dato: string). Url del ecommerce a la cual se desea volver si el pago es exitoso. Campo obligatorio.
return_url_failure:(Tipo de dato: string). Url del ecommerce a la cual se desea volver si el pago fue rechazado. Campo obligatorio.
notification_url: (Tipo de dato: string). Url del ecommerce a la cual se va a notificar el procesamiento del pago. Campo obligatorio.

{
    "provider": "gocuotas",
    "action": "create"
    "email": "comerciovendedor@gocuotas.com",
    "password": "gocuotas",
    "amount_in_cents": "1000", 
    "order_reference_id": "6608", 
    "url_success": "http://localhost:3000/checkout/6608/confirmacion", "url_failure":"http://localhost:3000/checkout/payment?gocuotas_error=true", 
    "webhook_url": "http://localhost:3000/gocuotas/notification", "payer_email":"contacto@pow.la"
 }

RESPONSE

url_init: url que redirecciona al sitio de Gocuotas para procesar el pago.

Nota: El "amount_in_cents" se devuelve con dos ceros más porque se toman como decimales.

{
    "url_init": "https://www.gocuotas.com/checkouts/155318",
    "amount_in_cents": 100000,
    "url_success": "http://localhost:3000/checkout/6608/confirmacion",
    "url_failure": "http://localhost:3000/checkout/payment?gocuotas_error=true",
    "order_reference_id": "6608",
    "webhook_url": "http://localhost:3000/gocuotas/notification",
    "email": "contacto@pow.la",
    "phone_number": null
}

# 2. Obtener pagos realizado

POST /pagos

Es un endpoint solamente informativo. Permite obtener todas las ventas en un determinado período.

REQUEST

provider: (Tipo de dato: string). Nombre del proveedor del servicio (govuotas). Campo obligatorio.
action: (Tipo de dato: string). Identificador de la acción a procesar (obtain_payment_info). Campo obligatorio.
email: (Tipo de dato: string). Email de gocuotas de la marca. Campo obligatorio.
password: (Tipo de dato: string). Password de la marca provisto por gocuotas. Campo obligatorio.
payment_id: (Tipo de dato: string). id de oagi provisto por gocuotas. Campo obligatorio.

{
    "provider": "gocuotas",
    "action": "obtain_payment_info",
    "email": "comerciovendedor@gocuotas.com",
    "password": "gocuotas",
    "payment_id": "3927044"
}

RESPONSE

Devuelve el pago.

Nota: El "amount_in_cents" se devuelve con dos ceros más porque se toman como decimales.

{
    "id": 3927044,
    "amount_in_cents": 729500,
    "status": "cancel",
    "delivered_at": "2024-04-17T14:07:20.375-03:00",
    "discarded_at": "2024-04-17T14:21:12.496-03:00",
    "number_of_installments": 4,
    "order_reference_id": "13156319",
    "payment": {
        "card": {
            "number": "404031******2943",
            "name": "Visa Lemon Cash"
        }
    }
}

# 3. Reembolsar pago

POST /pagos

El método permite hacer un reembolso (total o parcial) de un pago.

REQUEST

provider: (Tipo de dato: string). Nombre del proveedor del servicio (gocuotas). Campo obligatorio.
action: (Tipo de dato: string). Identificador de la acción a procesar (amount_in_cents). Campo obligatorio.
email: (Tipo de dato: string). Email de gocuotas de la marca. Campo obligatorio.
password: (Tipo de dato: string). Password de la marca provisto por gocuotas. Campo obligatorio.
amount: (Tipo de dato: string). Monto a devolver. Hay que multiplicarlo por 100 porque toma el valor en cents. Ejemplo: $4000 => $400000. Campo obligatorio.
paymet_id: (Tipo de dato: string). Id del pago a devolver. Campo obligatorio.

{
    "provider": "gocuotas",
    "action": "partial_refund",
    "amount": "100000",
    "payment_id":"12345",
    "email": "comerciovendedor@gocuotas.com",
    "password": "gocuotas"
}

RESPONSE

Devuelve un array con un objeto que indica:

id: id de pago.
amount_in_cents: Monto total en cents (los últimos dos números se toman como decimales)
status: Status del pago.

Nota: El "amount_in_cents" se devuelve con dos ceros más porque se toman como decimales.

[
  {
    "id": 0,
    "amount_in_cents": 0,
    "status": "string"
  }
]