TBBNMerchantDocs
Available

Sandbox

post/v1/sandbox/test-account

Switch on test mode for the signed-in rep's Merchant

curl -X POST https://api.tbbnetwork.com/v1/sandbox/test-account \
  -H "Authorization: Bearer <session access token>" \
  -H "Idempotency-Key: 5f2f...b91" \

Response (200)

FieldTypeRequired
testMerchantIdstring,null (uuid)—
sellersobject[]—
Example 200 response
{
  "testMerchantId": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "sellers": [
    {
      "sellerId": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "merchantSellerRef": "merchantSellerRef",
      "name": "Acme Co."
    }
  ]
}

Possible errors

Any other failure (validation, auth, rate limiting, a resource that doesn't exist) returns this same envelope with a non-2xx status — error.code is stable and safe to branch on; error.requestId is worth logging and including in a support request.

Example error response
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "A human-readable description of what went wrong.",
    "requestId": "req_01hxyz..."
  }
}
get/v1/sandbox/test-account

The signed-in rep's test account

curl -X GET https://api.tbbnetwork.com/v1/sandbox/test-account \
  -H "Authorization: Bearer <session access token>" \

Response (200)

FieldTypeRequired
testMerchantIdstring,null (uuid)—
sellersobject[]—
Example 200 response
{
  "testMerchantId": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "sellers": [
    {
      "sellerId": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "merchantSellerRef": "merchantSellerRef",
      "name": "Acme Co."
    }
  ]
}

Possible errors

Any other failure (validation, auth, rate limiting, a resource that doesn't exist) returns this same envelope with a non-2xx status — error.code is stable and safe to branch on; error.requestId is worth logging and including in a support request.

Example error response
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "A human-readable description of what went wrong.",
    "requestId": "req_01hxyz..."
  }
}
get/v1/sandbox/fixtures

Canned example request payloads (listing sync, offer create, matching candidates) for docs-site's live "try it" widgets — real shapes matching each service's actual DTOs

curl -X GET https://api.tbbnetwork.com/v1/sandbox/fixtures \
  -H "Authorization: Bearer sk_sandbox_..." \

Response (200)

Example 200 response
null