STBL

PayIn and PayOut services through P2P, acquiring, OCT

Supports in this guide: Payments, Payouts

Provider website: stbl.finance (the provider also uses other domains, e.g. stbl.solutions; stbl.world currently shows no content - confirm the current website with your account manager before sharing it with anyone)

What you need to do for start processing transactions (brief summary)

Get your credentials (from STBL)
Connect in Dashboard
Send an API request

Prerequisites: get from STBL

Contact your STBL account manager to get your account verified and receive the following credentials.

Username -> Corefy field username.
Password -> Corefy field password.
Webhook Secret -> Corefy field webhook_secret -> used to verify callback notifications from STBL.
Currency -> Corefy field currency -> ARS, KRW, BOB, or VES - set according to the currency agreed with STBL for your account.

Important

The account currency is fixed per connection. If you need to process more than one of ARS/KRW/BOB/VES, create a separate Provider account connection per currency.

Payments processing (connect Provider account, create payment-invoice)

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

Open STBL in the provider directory and press Connect at STBL Provider Overview page in the New connection section. Choose Provider account.

Step 2 - Fill in fields and select settings

Username
Password
Webhook Secret
Currency
Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected STBL Provider account!

First request to Corefy API (MIN)

What it does: creates a payment-invoice; the customer then receives payment requisites (a QR code, bank account details, or Pago Móvil details, depending on the method) to complete the transfer on their own.

Payment - MIN

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "8e3dbbb0-17af-4c9a-bedb-93bdac6900a2",
      "service": "qr_code_ars_invoice",
      "currency": "ARS",
      "amount": 100
    }
  }
}

This connector also supports qr_code_bob_invoice (BOB, QR code), bank_transfer_krw_invoice (KRW, bank transfer), and pagomovil_ves_invoice (VES, Pago Móvil) - use whichever matches your connection's Currency.

Important

For pagomovil_ves_invoice specifically, the customer must confirm the payment after completing the transfer, by submitting the transfer reference (ref) and phone number (phone_number) - check with your account manager how this confirmation step is triggered in your integration.

Payment - MAX

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "6795502c-e27d-4d07-85e0-93245aab9a3f",
      "service": "qr_code_ars_invoice",
      "currency": "ARS",
      "amount": 100,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Smith"
      }
    }
  }
}

customer is entirely optional - name, when sent, is forwarded to STBL as the payer's full name.

Extended request (MAX)

Why add extra fields (typical reasons): - Provide additional customer details for compliance/reconciliation - Positively influence conversion rate - Include optional fields required by your specific flow

No Options or Constants are configured for this connector.

Refunds

This connector does not support refunds.

Payouts processing (connect Provider account, create payout-invoice)

Connect Provider account in Corefy Dashboard

Uses the same Provider account connection as Payments above - one connection covers both directions, nothing extra to fill in for payouts specifically.

First request to Corefy API (MIN)

What it does: creates a payout-invoice and sends funds via bank transfer, in the currency set on your connection.

Payout - MIN (ARS)

POST /api/payout-invoices

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "0dde9e79-2c64-4703-adaf-93d710633401",
      "service": "bank_transfer_ars",
      "currency": "ARS",
      "amount": 100,
      "fields": {
        "bank_account": "0005067500000049702044",
        "beneficiary_full_name": "John Smith",
        "document_id": "20716406101"
      }
    }
  }
}

Important

fields.bank_account (CBU), fields.beneficiary_full_name, and fields.document_id (CUIT) are required for an ARS payout. Field requirements for other currencies may differ - confirm with your account manager.

Payout - MAX (ARS)

POST /api/payout-invoices

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "3c6d2f8e-8a2a-4e7a-9b1a-2f6a7b9c0d1e",
      "service": "bank_transfer_ars",
      "currency": "ARS",
      "amount": 100,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Smith"
      },
      "fields": {
        "bank_account": "0005067500000049702044",
        "beneficiary_full_name": "John Smith",
        "document_id": "20716406101"
      }
    }
  }
}

customer is entirely optional - name, when sent, is forwarded as the receiver's name.

Extended request (MAX)

Why add extra fields (typical reasons): - Provide additional customer details for compliance/reconciliation - Positively influence conversion rate - Include optional fields required by your specific flow

No Options or Constants are configured for this flow.

Additional info

Callback routing is automatic - Corefy generates the callback/return URLs per transaction, nothing to configure in STBL's own back-office.
Account currency is fixed per connection - create a separate Provider account connection for each currency (ARS/KRW/BOB/VES) you need.

FAQ / Troubleshooting

Invalid credentials / auth error -> verify Username/Password/Webhook Secret for the selected environment
Refund request fails -> this connector doesn't support refunds
Wrong currency / service mismatch -> each connection is locked to a single currency - make sure the service/currency in your request matches your connection's configured Currency

Question

Still looking for help connecting your STBL account? Please contact our support team!