STBL

Website: stbl.world

Set up Provider account

Step 1: Create Provider account

To create an account, contact your STBL manager directly. Submit the required documents to verify your account and gain access.

Step 2: Get required credentials

Credentials that have to be issued:

• stbl__username → Username
• stbl__password → Password
• stbl__currency → Currency
• stbl__webhook_secret → Webhook secret

Connect Provider Account

Step 1. Connect Provider account at the Corefy Dashboard

Press Connect at STBL Provider Overview page in 'New connection' section and choose Provider account option to open Connection form.

Enter credentials:

• Username
• Password
• Webhook secret
• Currency → choose the account currency (ARS, KRW, BOB, or VES; set this parameter according to the currency agreed with STBL for your account)
• Test mode → true/false

API examples:

Minimum data set to create a payment invoice for qr_code_ars_invoice service

PAYMENT

POST /api/payment-invoices HTTP/1.1
{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "service": "qr_code_ars_invoice",
      "currency": "ARS",
      "amount": 100,
      "test_mode": true
    }
  }
}

Maximum data set to create a payment invoice for qr_code_ars_invoice service

PAYMENT

POST /api/payment-invoices HTTP/1.1
{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "1783935395",
      "description": "Payment description",
      "service": "qr_code_ars_invoice",
      "currency": "ARS",
      "amount": 100,
      "test_mode": true,
      "customer": {
        "reference_id": "e615be14-cb1f-43bd-a3f5-c66c44a110bb",
        "name": "John Doe"
      }
    }
  }
}

Available payment services:

• qr_code_ars_invoice → ARS, QR code
• qr_code_bob_invoice → BOB, QR code
• bank_transfer_krw_invoice → KRW, bank transfer
• pagomovil_ves_invoice → VES, Pago Móvil

The customer.name value is passed to STBL as the payer's full name.

After the payment invoice is created, the customer receives the payment requisites (QR code, bank account, or Pago Móvil details) to complete the transfer. For the pagomovil_ves_invoice service, the customer must confirm the payment after completing the transfer by submitting the transfer reference (ref) and phone number (phone_number).

Minimum data set to create a payout invoice for bank_transfer_ars service

PAYOUT

POST /api/payout-invoices HTTP/1.1
{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "service": "bank_transfer_ars",
      "currency": "ARS",
      "amount": 100,
      "test_mode": true,
      "fields": {
        "bank_account": "0005067500000049702044",
        "beneficiary_full_name": "John Doe",
        "document_id": "20716406101"
      }
    }
  }
}

Maximum data set to create a payout invoice for bank_transfer_ars service

PAYOUT

POST /api/payout-invoices HTTP/1.1
{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "1783935395",
      "description": "Payout description",
      "service": "bank_transfer_ars",
      "currency": "ARS",
      "amount": 100,
      "test_mode": true,
      "customer": {
        "reference_id": "e615be14-cb1f-43bd-a3f5-c66c44a110bb",
        "name": "John Doe"
      },
      "fields": {
        "bank_account": "0005067500000049702044",
        "beneficiary_full_name": "John Doe",
        "document_id": "20716406101"
      }
    }
  }
}

Recipient fields (fields):

• bank_account → beneficiary bank account (CBU)
• beneficiary_full_name → beneficiary full name
• document_id → beneficiary document number (CUIT)

Additional information

Currency

The account currency is fixed per connection (currency field). Create a separate connection per currency if you need to process several of them.