> For the complete documentation index, see [llms.txt](https://startbutton.gitbook.io/startbutton-product-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://startbutton.gitbook.io/startbutton-product-api/reference/faqs.md).

# FAQs

<details>

<summary>How to get your authorization tokens</summary>

This can be found on your Startbutton Dashboard. Go to your ‘Account Settings’ page and tap on API keys to view, generate, or copy your token.

</details>

<details>

<summary>How to set your <code>redirect_url</code></summary>

Go to your ‘Account Settings’ page and tap on API keys, then click edit to set a `redirect_url`.

</details>

<details>

<summary>How to add your <code>webhook_url</code></summary>

Go to your ‘Account Settings’ page and tap on API keys, then click edit to add a `webhook_url`.

</details>

<details>

<summary>Payout request</summary>

Make payouts to your local currency through your Startbutton dashboard or an [Transfer — Overview](/startbutton-product-api/payouts/transfer-overview.md).

</details>

<details>

<summary>Currency conversion</summary>

On your Startbutton dashboard, you can convert the collected funds between supported currency pairs. We convert at the most favorable market FX rate.

</details>

<details>

<summary>How long does it take for a transaction to move to “abandoned” status?</summary>

Minimum of an Hour.

</details>

<details>

<summary>Can I provide more than 1 settlement account?</summary>

Yes, you can.

</details>

<details>

<summary>Why is my ledger balance, different from my available balance after a successful collection?</summary>

When a collection status is `verified`, the money will only reflect on your ledger balance until it is settled then it reflects on both your *available balance* and *ledger balance*.

</details>

<details>

<summary>What is the list of available statuses and their meaning? See <a href="/startbutton-product-api/collections/transaction-statuses.md">here</a>.</summary>

1. “initiated” means the transaction has been initiated.
2. “pending” means the transaction has been acknowledged
3. “verified” means the payment has been received and verified by the payment processor.
4. “successful” means we have been settled by the payment processor and the funds are now in your available balance.
5. “abandoned” means the transaction was initiated, but never completed.
6. “failed: means the transaction attempted to be completed but failed.

</details>

<details>

<summary>Are callbacks sent for failed Collections?</summary>

There are no callbacks, however, you receive a message when the transaction fails and the status of the transaction changes to FAILED. Alternatively, you can get the status of the transaction by calling the [Transaction Status Query](/startbutton-product-api/webhooks/transaction-status-query.md)

</details>

<details>

<summary>What do webhooks <code>collection.verified</code> and <code>collection.completed</code> imply?</summary>

`Collection.verified` event means the payment (collection) has been validated & pending settlement. (This applies to currencies that the settlement timeline isn’t instant)- e.g ZAR take T+2. \
While the `collection.completed` event means the payment is "verified" and "successful." Until a transaction is successful, it isn't ready for payout (meaning it will only be added to your ledger balance). But once it is successful it is settled and added to your available balance. Also note, verified transactions count as successful transactions, but they are just pending settlement. So we advise giving value to customers when transactions are in verified status. For more details on settlement timelines, check [Available Currencies](/startbutton-product-api/reference/available-currencies.md)

</details>