Checkout Redirect

La integración en un comercio online mediante la opción de checkout Redirect requiere la creación de una Solicitud de pago (Creación de solicitud de pago ) y la redireción a la URL obtenida en la response de este método, en el parámetro checkout_url

Al redirigir al checkout de SimpleFi, es necesario incluir los parámetros de redirección hacia la web del comercio una vez que concluya la operación en el checkout. Estos parámetros son:

• redirect_url: URL de la plataforma del comercio donde se desea redirigir al usuario una vez que el pago es exitoso.

• error_url: URL de la plataforma del comercio donde se desea redirigir al usuario una vez que el pago no es exitoso.

Ejemplo:

Desde la plataforma, se crea una orden mediante la siguiente petición:

curl -X POST https://api.simplefi.tech/payment_request \
-H "Content-Type: application/json" \
-d '{
  "ars_amount": 1000,
  "amount": 0.002,
  "currency": "ARS",
  "card_payment": false,
  "reference": {
    "order_id": "123456789"
  },
  "memo": "Compra en Café Cuyo",
  "coins": [
    {
      "ticker": "BCH",
      "chain_id": 1
    }
  ],
  "notification_url": "https://tuweb.com/notificacion",
  "merchant_id": "cafecuyo123"
}'

La respuesta de este método será:

{
  "id": "671cf4fe9a8949e0d537802f",
  "order_id": 123456789,
  "ars_amount": 1000,
  "ars_paid": 0,
  "amount": 0.002,
  "amount_paid": 0,
  "currency": "ARS",
  "usd_amount": 2.5,
  "reference": {
    "order_id": "123456789"
  },
  "memo": "Compra en Café Cuyo",
  "notification_url": "https://tuweb.com/notificacion",
  "status": "pending",
  "status_detail": "not_paid",
  "expiration_time": "2024-10-26T14:55:16.576Z",
  "delivered": true,
  "transactions": [
    {
      "id": "tx12345",
      "price_details": {
        "currency": "ARS",
        "currency_amount": 1000,
        "currency_final_amount": 1000,
        "base_amount": 0.002,
        "final_amount": 0.002,
        "paid_amount": 0,
        "discount_rate": 0,
        "rate": 500000
      },
      "coin": "BCH",
      "chain_id": 1,
      "address": "qz7ff5d9k2...",
      "status": "not_paid",
      "payment_request_id": "671cf4fe9a8949e0d537802f",
      "memo": "Compra en Café Cuyo",
      "additional_info": {},
      "payments": [],
      "date_created": "2024-10-26T14:55:16.576Z",
      "last_modified": "2024-10-26T14:55:16.576Z"
    }
  ],
  "payments": [],
  "merchant_id": "cafecuyo123",
  "checkout_url": "https://pagar.simplefi.tech/cafe-cuyo/payment/671cf4fe9a8949e0d537802f",
  "date_created": "2024-10-26T14:55:16.576Z",
  "last_modified": "2024-10-26T14:55:16.576Z"
}

Se debe tomar el checkout_url, agregar los parámetros de redirección, y redirigir al usuario:

Ejemplo URL para redirección:

https://pagar.simplefi.tech/cafe-cuyo/payment/671cf4fe9a8949e0d537802f?redirect_url=https://tuweb.com/notificacion/pago_exitoso/123456&error_url=https://tuweb.com/notificacion/pago_fallido/123456