Skip to content

Your credentials ​

Saving the form returns three values. This is the only time the secret is shown — Bito never returns it in any other response. The api_key is stored on the integration record: reading the integration (getOne) returns it in response_fields (the api-key field), even though the panel does not display it. Copy both into your secret store now anyway.

Response

json
{
    "code": 0,
    "message": "Success",
    "data": {
        "_id": "6712f0a9c4d1e87b3a0f1122",
        "client_id": "69c50a2d50f7b939923a469b",
        "secret": "4f3c1a9e8b27d605f1ac93e7d284b6510ff7a3c9e15d8b2470a6cd91e83f4b27",
        "api_key": "mycompany:9ad41c0e7b3f28d5610ac94e7f1b26d8"
    },
    "time": "2025-01-15T10:30:00.000Z"
}
ValueUsed forRotatable
client_idIdentifies your integration in every OAuth call and in the widget token. Permanent.No — it is the identity itself
secretOAuth client secret. Also the HS256 key you verify the one-time token with.Yes — see rotating credentials
api_keyThe simpler auth path: send it as the api-key header on Integration API calls. Format is <username>:<token>. Works once the integration is installed.Yes — in the panel together with the secret, or on its own over the API

WARNING

If you lose the secret, it cannot be read back. Rotate it to get a new one — which disconnects every merchant currently connected. Store it properly the first time.

Bito 2.0 Integration API