BluebulbAPI
    Using the API

    Statuses

    Conversions and payouts complete in the background. Poll their status with Get a conversion and Get a payout until they reach a final state.

    Conversion statuses

    Check with Get a conversion. Final states: completed and failed.

    processing
    Accepted. The amount has been debited from your fromCurrency balance and the conversion is under way.
    pending
    Accepted and waiting to be processed.
    completed
    Done. convertedAmount is in your toCurrency balance and actualCompletionTime is set.
    refund_pending
    The conversion couldn't be completed and the debited amount is being refunded.
    failed
    The conversion didn't complete. The debited amount is returned to your fromCurrency balance.
    expired
    The conversion expired before it could be completed.

    Payout statuses

    Check with Get a payout, by payout ID or your customerReference. Final states: successful and failed.

    queued
    Accepted and waiting to be processed. Most API payouts start here.
    pending
    In progress: being reviewed by Bluebulb or sent to the payment provider and awaiting confirmation. NGN payouts start here.
    successful
    Paid to the beneficiary.
    failed
    The payout didn't complete. When the funds have been returned to your balance, refundStatus is refunded.

    A payout can stay pending for a while — how long depends on the currency, the payout type and any review it needs.

    Cross-currency payout intent Rolling out

    A conversion created by a cross-currency payout also carries payoutIntent.status:

    pending
    Waiting for the conversion to complete.
    created
    The payout has been created — follow it using payoutIntent.payoutId.
    failed
    The payout couldn't be created; payoutIntent.failureReason says why. The converted funds are in your destination-currency balance (or refunded to your source balance if the conversion itself failed).

    Sub-wallet statuses Rolling out

    Only active sub-wallets credit payments to your balance.

    pending
    The banking partner is still opening the account. Check it with Refresh a sub-wallet's status.
    active
    Open. Completed payments into it are credited to your NGN balance.
    inactive
    The banking partner reports the account as inactive.
    deactivated
    You deactivated it. Payments sent to it aren't credited. Undo with Reactivate a sub-wallet.