Errors
Entity Errors
Error codes with the tenants- and counterparties- prefixes. See the
Errors overview for the response format and the code convention.
Tenants
| Error Code | HTTP Status | Error Message | Description |
|---|---|---|---|
tenants-1000 | 404 | Tenant not found | The specified tenant ID does not exist |
tenants-1001 | 500 | Tesser can't find the workspace your session belongs to, so it can't list the workspace and its tenants as owners. This is a fault at Tesser, not in your request: contact Tesser support; retrying won't help | Tesser lists your workspace and its tenants as the owners accounts and payments can be filtered by. Returned when Tesser has no record of the workspace your session belongs to, which is a fault at Tesser. Contact Tesser support with the workspace_id from the message. Retrying won't help. |
tenants-3001 | 400 | business_legal_name is required and must be 1-255 characters | User provides a business_legal_name that doesn't meet length requirements |
tenants-3002 | 400 | business_address_country must be a valid ISO 3166-1 alpha-2 country code | User provides a business_address_country that is not a valid 2-letter country code |
tenants-3003 | 400 | webhook_url must be an HTTPS URL on port 443 | User provides a webhook_url that is not an HTTPS URL on port 443 |
Counterparties
| Error Code | HTTP Status | Error Message | Description |
|---|---|---|---|
counterparties-1000 | 404 | Counterparty not found | The specified counterparty ID does not exist |
counterparties-1001 | 404 | Tenant not found. Cannot assign counterparty to non-existent tenant. | User tries to assign a counterparty to a tenant_id that doesn't exist |
counterparties-3002 | 400 | classification must be 'individual' or 'business' | User provides a classification value that is not 'individual' or 'business' |
counterparties-3003 | 400 | business_legal_name is required for business counterparties and must be 1-255 characters | User creates a business counterparty with missing or improperly formatted business_legal_name |
counterparties-3004 | 400 | business_address_country is required for business counterparties and must be a valid ISO 3166-1 alpha-2 country code | User provides a business_address_country that is not a valid 2-letter country code (e.g., "US", "GB") |
counterparties-3005 | 400 | individual_first_name is required for individual counterparties and must be 1-255 characters | User creates an individual counterparty with missing or improperly formatted first name |
counterparties-3006 | 400 | individual_last_name is required for individual counterparties and must be 1-255 characters | User creates an individual counterparty with missing or improperly formatted last name |
counterparties-3007 | 400 | individual_address_country is required for individual counterparties and must be a valid ISO 3166-1 alpha-2 country code | User provides an individual_address_country that is not a valid 2-letter country code |
counterparties-3008 | 400 | individual_date_of_birth must be a valid date in YYYY-MM-DD format | User provides a date_of_birth that doesn't match the required format or is not a valid date |
counterparties-3009 | 400 | tenant_id must be a valid UUID | User provides a tenant_id that is not a validly formatted UUID |
counterparties-3010 | 400 | individual_street_address1 is required for individual counterparties | User creates an individual counterparty without providing the street address |
counterparties-3011 | 400 | individual_city is required for individual counterparties | User creates an individual counterparty without providing the city |
counterparties-3012 | 400 | individual_postal_code is required for individual counterparties | User creates an individual counterparty without providing the postal code |
counterparties-3013 | 400 | business_street_address1 is required for business counterparties | User creates a business counterparty without providing the street address |
counterparties-3014 | 400 | business_city is required for business counterparties | User creates a business counterparty without providing the city |
counterparties-3015 | 400 | business_postal_code is required for business counterparties | User creates a business counterparty without providing the postal code |
counterparties-3016 | 400 | The originator or beneficiary of this payment is a wallet cluster: a counterparty Tesser creates for sending wallets whose owner is unknown, so it has no identity Tesser can send to the provider. Use an account owned by an individual or business counterparty for that side (funding_account_id for the originator, desired.to.account_id for the beneficiary) and resend; retrying won't help | Payouts and off-ramps send the originator's and beneficiary's identity to the provider, so both must be individual or business counterparties. A wallet cluster is a counterparty Tesser creates while screening a payment, for sending wallets whose owner is unknown, and it has no legal identity. Returned when a PATCH accepts a Zuba or Kraken-Zuba quote or locks a cross-ramp payment and the counterparty that owns funding_account_id (the originator) or desired.to.account_id (the beneficiary) is a wallet cluster. Zuba and Kraken-Zuba payouts check both parties; a cross-ramp payment checks the beneficiary. The party and counterparty_id params say which. Nothing was locked or sent. Register the party as an individual or business counterparty, use one of its accounts and resend. Retrying the same request won't help. A Kraken-Zuba payout whose originator is a wallet cluster is held with transfers-9209 (reason payout_refused) and this code in the hold's detail. |
Last modified on