Skip to content

Logo

Nebeus

Merge money and crypto in one app. Your new way of paying.

Supports in this guide: Payouts

Provider website: nebeus.com

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

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

Prerequisites: get from Nebeus

Send a connection request at app.nebeus.com/signup or contact your Nebeus account manager directly to get your account verified and receive the following credentials.

  • User ID -> Corefy field user_id.
  • API key -> Corefy field api_key.

Available currencies depend on the routes configured for your account.

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

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • User ID
  • API key
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Nebeus Provider account!

First request to Corefy API (MIN)

What it does: creates a payout-invoice and sends funds directly to a card.

Payout - MIN

POST /api/payout-invoices 

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "c0f84819-85fd-43f3-bfdd-bf1fc5755965",
      "service": "payment_card_usd",
      "currency": "USD",
      "amount": 10,
      "fields": {
        "card_number": "4111111111111111"
      }
    }
  }
}

Important

fields.card_number is required.

Payout - MAX

POST /api/payout-invoices 

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "d0e1022c-721c-4b8f-a89d-9e2f6d0dbda7",
      "service": "payment_card_usd",
      "currency": "USD",
      "amount": 10,
      "customer": {
        "name": "John Doe"
      },
      "fields": {
        "card_number": "4111111111111111"
      }
    }
  }
}

customer.name is split into first/last name and sent to Nebeus as the recipient's cardholder name. No Options or Constants are configured for this connector.

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

Refunds

Nebeus does not support refunds.

Additional info

  1. Active reconciliation is available - payout status can be retrieved via an active status request.
  2. The payout is executed as a two-step process (create, then execute) behind a single payout-invoice request - nothing extra to configure on your side.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify the User ID and API key for the selected environment (test_mode)
  • Currency or service is not supported -> confirm allowed currencies/features in your Nebeus account and in Corefy

Question

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