Skip to content

Logo

TBN

Explore seamless and secure crypto payment solutions.

Supports in this guide: Payments

Provider website: tbnotc.com

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

  1. Get your credentials (from TBN)
  2. Connect in Dashboard
  3. Send an API request

Prerequisites: get from TBN

Send a connection request at tbnotc.com/contact-us or contact your TBN account manager directly to get your account verified and receive the following credentials.

  • Client ID -> Corefy field client_id.
  • Client Secret -> Corefy field client_secret.

Note

You may need to whitelist Corefy's IPs on TBN's side - ask your account manager and provide the production/test IPs from the integration docs.

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

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Client ID
  • Client Secret
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected TBN Provider account!

First request to Corefy API (MIN)

What it does: creates a payment-invoice and redirects the customer to TBN's hosted crypto checkout.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "189456123",
      "service": "crypto_usd_hpp",
      "currency": "USD",
      "amount": 100
    }
  }
}

Important

customer is not used at all by this connector - there's no MAX variant, the request above already includes everything TBN's API accepts.

Refunds

TBN does not support refunds.

Additional info

  1. No active reconciliation - TBN payment statuses arrive only via the asynchronous callback; there is no active status request available for this connector.
  2. No recurring - this connector does not support saving/charging a token through Corefy.
  3. No Options or Constants are configured for this connector.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify Client ID and Client Secret for the selected environment (test_mode)
  • Payment stuck pending with no status update -> this connector has no active status request; confirm your callback endpoint is reachable and correctly configured
  • Currency or service is not supported -> confirm allowed currencies/features in your TBN account and in Corefy
  • Refund fails -> TBN does not support refunds through Corefy

Question

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