Docs
Español
Español
  • SimpleFi
    • Pagos en tienda física
    • Pagos en tienda online
    • Tokens disponibles
  • Gestión del comercio
    • Autenticación
    • Configuración del negocio
    • Solicitudes de pago
    • Notificaciones de estado
    • QR estático
  • Checkout
    • 1. Declaración del monto
    • 2. Selección de token
    • 3. Pago
    • 4. Confirmación del pago
  • Referencia de la API
    • Autenticación
    • Errores
    • Creación de solicitud de pago
    • Consulta del estado de un pago
    • Cancelar una solicitud de pago
    • Devolver un pago
    • Webhook de notificaciones
    • Vincular comercio a red
  • Detalles de implementación según método
    • Checkout Redirect
    • QR Dinámico
Powered by GitBook
On this page
  1. Detalles de implementación según método

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

PreviousDetalles de implementación según métodoNextQR Dinámico

Last updated 7 months ago