Common Errors

"Payment limit reached"

You are on the Free plan and have reached 30 payments this month. Options:

• Wait until the 1st of next month for the count to reset.
• Upgrade to Pro for unlimited payments.

"Payment link expired"

The payment link is more than 7 days old and has not been paid. You can reactivate it from your dashboard.

"Invalid API key"

The API key in your request is incorrect or has been rotated. Check:

• You are using the latest key from your Developers page.
• The key is in the X-API-Key header, not a query parameter.
• There are no extra spaces or characters.

"Webhook delivery failed"

Brykto tried to deliver the webhook to your URL 3 times and received an error or timeout. Check:

• Your webhook URL is publicly accessible (not localhost).
• Your server returns a 200 status code within 10 seconds.
• Your firewall is not blocking incoming requests.

From the Developers page you can retry webhook delivery for a specific payment.

"Trustline not set"

Your wallet does not have a trustline for USDC or RLUSD. You need to add it before you can receive stablecoin payments. See Wallet Connection Issues.