Creación de solicitud de pago

Las solicitudes de pago se crean a partir de un monto en pesos, y contienen la información de la cotización de la orden en cada noneda disponible para realizar el pago. Para iniciar un pago, es necesario primero que se cree la solicitud de pago.

La ruta para crearlos recibe un monto en pesos y las monedas aceptadas, y el backend calcula la cotización en cada moneda y la guarda en la base de datos. El sistema de SimpleFi escucha las blockchains de todas las monedas aceptadas y actualiza las solicitudes de pago cuando se encuentran los pagos correspondientes.

Para crear una solicitud de pago:

Create Payment Request

post
Authorizations
Body
ars_amountany ofOptional
numberOptional
or
nullOptional
amountany ofOptional
numberOptional
or
nullOptional
currencyany ofOptional
string · enumOptionalPossible values:
or
nullOptional
itemsany ofOptional
or
nullOptional
card_paymentany ofOptionalDefault: false
booleanOptional
or
nullOptional
referenceobject · ReferenceRequired
memoany ofOptional
stringOptional
or
nullOptional
coinsany ofOptional
or
nullOptional
notification_urlany ofOptional
stringOptional
or
nullOptional
merchant_idany ofOptional
anyOptional
or
nullOptional
Responses
201

Successful Response

application/json
post
POST /payment_requests HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 214

{
  "ars_amount": 1,
  "amount": 1,
  "currency": "ARS",
  "items": [
    {
      "id": null,
      "quantity": 1
    }
  ],
  "card_payment": false,
  "reference": {},
  "memo": "text",
  "coins": [
    {
      "ticker": "BTC",
      "chain_id": 1
    }
  ],
  "notification_url": "text",
  "merchant_id": null
}
{
  "id": "text",
  "order_id": 1,
  "ars_amount": 1,
  "ars_paid": 1,
  "amount": 1,
  "amount_paid": 1,
  "currency": "ARS",
  "items": [
    {
      "id": "text",
      "quantity": 1,
      "name": "text",
      "price": 1,
      "currency": "ARS"
    }
  ],
  "usd_amount": 1,
  "reference": {},
  "memo": "text",
  "notification_url": "text",
  "status": "pending",
  "status_detail": "not_paid",
  "approved_at": "2025-08-29T18:02:01.285Z",
  "expiration_time": "2025-08-29T18:02:01.285Z",
  "delivered": true,
  "transactions": [
    {
      "id": "text",
      "price_details": {
        "currency": "ARS",
        "currency_amount": 1,
        "currency_final_amount": 1,
        "base_amount": 1,
        "final_amount": 1,
        "paid_amount": 1,
        "discount_rate": 1,
        "rate": 1
      },
      "coin": "BTC",
      "chain_id": 1,
      "address": "text",
      "status": "not_paid",
      "payment_request_id": "text",
      "memo": "text",
      "additional_info": {},
      "payments": [
        {
          "hash": "text",
          "from": "text",
          "chain_id": 1,
          "block": 1,
          "amount": 1,
          "paid_by": "text",
          "paid_at": "2025-08-29T18:02:01.285Z",
          "linked_at": "2025-08-29T18:02:01.285Z"
        }
      ],
      "date_created": "2025-08-29T18:02:01.285Z",
      "last_modified": "2025-08-29T18:02:01.285Z"
    }
  ],
  "card_payment": {
    "provider": "stripe",
    "session_url": "text",
    "price_details": {
      "currency": "ARS",
      "amount": 1,
      "final_amount": 1,
      "usd_final_amount": 1,
      "paid_amount": 1,
      "discount_rate": 1,
      "rate": 1
    },
    "status": "not_paid",
    "date_created": "2025-08-29T18:02:01.285Z",
    "last_modified": "2025-08-29T18:02:01.285Z"
  },
  "payments": [
    {
      "hash": "text",
      "from": "text",
      "chain_id": 1,
      "block": 1,
      "amount": 1,
      "paid_by": "text",
      "paid_at": "2025-08-29T18:02:01.285Z",
      "linked_at": "2025-08-29T18:02:01.285Z",
      "coin": "BTC"
    }
  ],
  "merchant_id": "text",
  "date_created": "2025-08-29T18:02:01.285Z",
  "last_modified": "2025-08-29T18:02:01.285Z",
  "checkout_url": "text",
  "conflict": true
}

  • El campo 'reference' puede ser utilizado libremente para crear una referencia a este solicitud de pago.

  • En el atributo 'coins' contiene un array con formato [{'ticker': 'USDC', 'chain_id': 10}, {..}]donde se debe indicar el ticker de cada moneda que se quiere ofrecer como opción. Todas las monedas indicadas que no tengan una dirección configurada en el Negocio, se ignorarán. La API responderá con cotizaciones para todos los tokens que tengan dirección configurada en el negocio.

  • El campo 'notification_url' es opcional. Permite indicar una URL distinta a la configurada en el negocio para recibir las notificaciones asociadas a esta transacción.

Mirá los tokens disponibles.

Obtención de QR de único uso

Es posible obtener un QR vinculado a una Solicitud de pago específica. Este QR redirige al checkout vinculando el pago con la orden creada por backoffice en el sistema de SimpleFi o el sistema de la red de pagos.

Create Payment Request With Qr

post
Authorizations
Body
ars_amountany ofOptional
numberOptional
or
nullOptional
amountany ofOptional
numberOptional
or
nullOptional
currencyany ofOptional
string · enumOptionalPossible values:
or
nullOptional
itemsany ofOptional
or
nullOptional
card_paymentany ofOptionalDefault: false
booleanOptional
or
nullOptional
referenceobject · ReferenceRequired
memoany ofOptional
stringOptional
or
nullOptional
coinsany ofOptional
or
nullOptional
notification_urlany ofOptional
stringOptional
or
nullOptional
merchant_idany ofOptional
anyOptional
or
nullOptional
Responses
201

Successful Response

No content
post
POST /payment_requests/qr HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 214

{
  "ars_amount": 1,
  "amount": 1,
  "currency": "ARS",
  "items": [
    {
      "id": null,
      "quantity": 1
    }
  ],
  "card_payment": false,
  "reference": {},
  "memo": "text",
  "coins": [
    {
      "ticker": "BTC",
      "chain_id": 1
    }
  ],
  "notification_url": "text",
  "merchant_id": null
}
No content
PreviousErroresNextConsulta del estado de un pago

Last updated