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

OAuth2PasswordBearerExtended

OAuth2passwordRequired

Token URL:

Body

application/json

ars_amountany ofOptional

numberOptional

or

nullOptional

amountany ofOptional

numberOptional

or

nullOptional

currencyany ofOptional

string · enumOptionalPossible values:

or

nullOptional

itemsany ofOptional

or

nullOptional

memoany ofOptional

stringOptional

or

nullOptional

coinsany ofOptional

or

nullOptional

card_paymentany ofOptionalDefault: false

booleanOptional

or

nullOptional

notification_urlany ofOptional

stringOptional

or

nullOptional

merchant_idany ofOptional

anyOptional

or

nullOptional

Responses

201

Successful Response

application/json

idstringRequired

order_idintegerRequired

ars_amountnumberRequired

ars_paidnumberRequired

amountnumberRequired

original_amountany ofOptional

numberOptional

or

nullOptional

card_amountany ofOptional

numberOptional

or

nullOptional

amount_paidnumberRequired

currencystring · enumRequiredPossible values:

itemsany ofOptional

or

nullOptional

usd_amountnumberRequired

memoany ofOptional

stringOptional

or

nullOptional

notification_urlany ofOptional

stringOptional

or

nullOptional

statusstring · enumRequiredPossible values:

status_detailstring · enumRequiredPossible values:

approved_atany ofOptional

string · date-timeOptional

or

nullOptional

expiration_timestring · date-timeRequired

deliveredbooleanRequired

card_paymentany ofOptional

or

nullOptional

stripe_invoiceany ofOptional

or

nullOptional

merchant_idstringRequired

installment_plan_idany ofOptional

stringOptional

or

nullOptional

pricing_modestring · enumOptionalDefault: crypto_basePossible values:

crypto_discountnumberOptionalDefault: 0

extra_chargenumberOptionalDefault: 0

is_remaining_balance_paymentbooleanOptionalDefault: false

poap_mintedbooleanOptionalDefault: false

offramp_statusany ofOptional

stringOptional

or

nullOptional

offramp_dataany ofOptional

or

nullOptional

date_createdstring · date-timeRequired

last_modifiedstring · date-timeRequired

checkout_urlstringRead-onlyRequired

checkout_v2_urlstringRead-onlyRequired

conflictbooleanRead-onlyRequired

422

Validation Error

application/json

post

/payment_requests

HTTPcURLJavaScriptPython

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

{
  "ars_amount": 1,
  "amount": 1,
  "currency": "ARS",
  "items": [
    {
      "id": null,
      "quantity": 1
    }
  ],
  "reference": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "memo": "text",
  "coins": [
    {
      "ticker": "BTC",
      "chain_id": 1
    }
  ],
  "card_payment": false,
  "redirect_urls": {
    "success_url": "text",
    "cancel_url": "text"
  },
  "notification_url": "text",
  "merchant_id": null
}

{
  "id": "text",
  "order_id": 1,
  "ars_amount": 1,
  "ars_paid": 1,
  "amount": 1,
  "original_amount": 1,
  "card_amount": 1,
  "amount_paid": 1,
  "currency": "ARS",
  "items": [
    {
      "id": "text",
      "quantity": 1,
      "name": "text",
      "price": 1,
      "currency": "ARS"
    }
  ],
  "usd_amount": 1,
  "reference": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "memo": "text",
  "notification_url": "text",
  "redirect_urls": {
    "success_url": "text",
    "cancel_url": "text"
  },
  "status": "pending",
  "status_detail": "not_paid",
  "approved_at": "2026-03-17T17:40:34.535Z",
  "expiration_time": "2026-03-17T17:40:34.535Z",
  "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": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "payments": [
        {
          "hash": "text",
          "from": "text",
          "chain_id": 1,
          "block": 1,
          "amount": 1,
          "paid_by": "text",
          "paid_at": "2026-03-17T17:40:34.535Z",
          "linked_at": "2026-03-17T17:40:34.535Z"
        }
      ],
      "date_created": "2026-03-17T17:40:34.535Z",
      "last_modified": "2026-03-17T17:40:34.535Z"
    }
  ],
  "card_payment": {
    "provider": "stripe",
    "session_url": "text",
    "payment_intent_id": "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",
    "card_last4": "text",
    "card_brand": "text",
    "date_created": "2026-03-17T17:40:34.535Z",
    "last_modified": "2026-03-17T17:40:34.535Z"
  },
  "stripe_invoice": {
    "invoice_id": "text",
    "subscription_id": "text",
    "invoice_number": "text",
    "invoice_url": "text",
    "invoice_pdf": "text",
    "period_start": "2026-03-17T17:40:34.535Z",
    "period_end": "2026-03-17T17:40:34.535Z",
    "paid_at": "2026-03-17T17:40:34.535Z"
  },
  "payments": [
    {
      "hash": "text",
      "from": "text",
      "chain_id": 1,
      "block": 1,
      "amount": 1,
      "paid_by": "text",
      "paid_at": "2026-03-17T17:40:34.535Z",
      "linked_at": "2026-03-17T17:40:34.535Z",
      "coin": "BTC"
    }
  ],
  "merchant_id": "text",
  "installment_plan_id": "text",
  "pricing_mode": "crypto_base",
  "crypto_discount": 0,
  "extra_charge": 0,
  "is_remaining_balance_payment": false,
  "poap_minted": false,
  "offramp_status": "text",
  "offramp_data": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "date_created": "2026-03-17T17:40:34.535Z",
  "last_modified": "2026-03-17T17:40:34.535Z",
  "checkout_url": "text",
  "checkout_v2_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

OAuth2PasswordBearerExtended

OAuth2passwordRequired

Token URL:

Body

application/json

ars_amountany ofOptional

numberOptional

or

nullOptional

amountany ofOptional

numberOptional

or

nullOptional

currencyany ofOptional

string · enumOptionalPossible values:

or

nullOptional

itemsany ofOptional

or

nullOptional

memoany ofOptional

stringOptional

or

nullOptional

coinsany ofOptional

or

nullOptional

card_paymentany ofOptionalDefault: false

booleanOptional

or

nullOptional

notification_urlany ofOptional

stringOptional

or

nullOptional

merchant_idany ofOptional

anyOptional

or

nullOptional

Responses

201

Successful Response

No content

422

Validation Error

application/json

post

/payment_requests/qr

HTTPcURLJavaScriptPython

POST /payment_requests/qr HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 309

{
  "ars_amount": 1,
  "amount": 1,
  "currency": "ARS",
  "items": [
    {
      "id": null,
      "quantity": 1
    }
  ],
  "reference": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "memo": "text",
  "coins": [
    {
      "ticker": "BTC",
      "chain_id": 1
    }
  ],
  "card_payment": false,
  "redirect_urls": {
    "success_url": "text",
    "cancel_url": "text"
  },
  "notification_url": "text",
  "merchant_id": null
}

No content