Sign in

v2

latestOpenAPI 3.0.02026-07-3139594346.4 KB
Configuration

Set Callback URLs

Configure callbacks URLs for a Bolt merchant division. This will store or override only the callback URLs that are specified in the request. Operations are fully transactional.

post/v1/merchant/callbacks

Request body

division_idstring required

The unique ID associated to the merchant's Bolt Account division; Merchants can have different divisions to suit multiple use cases (storefronts, pay-by-link, phone order processing). Use the Bolt Merchant Dashboard to switch between divisions and find the division ID under Merchant Division Public ID.

Example request

{
  "callback_urls": [
    {
      "type": "oauth_redirect",
      "url": "https://example.com/1"
    },
    {
      "type": "oauth_logout",
      "url": "https://example.com/2"
    },
    {
      "type": "get_account",
      "url": "https://example.com/3"
    }
  ],
  "division_id": "3X9aPQ67-YrB"
}

Response

Successfully sets callback URLs. No JSON schema is expected.