Troubleshooting

Start with the message on the page and the latest invoice or transaction status. A timeout or delayed dashboard update does not always mean the transaction failed.

Account setup or invoice creation is blocked#

  • Safe setup is incomplete: finish onboarding and any wallet prompts, then reopen the dashboard. A login alone does not mean the Safe has been deployed.
  • Business profile is required: complete every required field in Complete Your Business Profile, including the address and company registration number for entities.
  • A customer cannot be saved: check the email and all four address fields. Companies require a registration number. An optional wallet address must be a valid EVM address.
  • The invoice form will not submit: select a customer, enter a positive USDC amount, and choose a due date. The due date is required.

See Get started, Business profile, and Customers.

A payment link will not open#

Share link needed means the URL has no token parameter. Reopen the complete link from the merchant, including ?token=.... Connecting a wallet does not unlock the details.

For an invalid, expired, or revoked token, ask the merchant for a new link. A merchant can open Share Invoice to create a token or regenerate the default link. Regeneration invalidates the old default link, including copies in earlier emails.

For Invoice not found, check the invoice ID, deployment, and whether issuance has confirmed. A missing result is not evidence that the on-chain invoice was deleted.

Metadata is unavailable or verification fails#

Reload the full link after checking your connection. If the page still cannot load or verify the private details, contact the merchant. Legacy invoices may have no recoverable metadata.

The pay page blocks payment if the metadata hash does not match the on-chain record. Do not bypass this by transferring USDC directly to an address. A direct transfer does not mark the invoice Paid through the settlement contract.

Wallet connection or payment fails#

  • Unlock your wallet and approve the connection request. Use a connector offered by the page.
  • Switch to the invoice's network. USDC and ETH balances on another network do not count.
  • Fund the connected wallet with the full invoice amount in USDC. External-wallet transactions also need ETH for gas.
  • Complete both the permit-signature and transaction prompts in the external-wallet flow. A signed permit alone is not payment.
  • If your wallet cannot sign the required permit, use a compatible wallet. Not every smart-contract wallet supports this flow.
  • If the invoice is already Paid or Canceled, it cannot be paid again. For a designated-payer invoice, the connected address must also match the designated payer.

For the supported embedded-wallet path, a sponsorship or service failure can prevent submission. Check the displayed error rather than assuming gas sponsorship is always available. See Pay an invoice.

A transaction is pending or a list looks stale#

Check the transaction link or hash and refresh the invoice details. The invoice list and payment history can lag behind chain confirmation.

Before repeating an issuance, payment, cancellation, or withdrawal, establish whether the first attempt succeeded. For a pending payment, use Refresh Page to Check Status. For a pending cancellation, wait for Canceled rather than treating submission as completion.

The invoice exists but the email did not arrive#

Open Email Delivery in the invoice details. provider_accepted means the provider accepted a send request, not that it reached the inbox. Check the recipient email, spam folder, and any failure reason.

Use Send invoice email, Retry email delivery, or Resend with new link when offered. If issuance was pending, inspect delivery again after confirmation; there is no guaranteed automatic deferred send. You can always copy an available share link and send it yourself. See Share invoices.

A download or withdrawal is unavailable#

  • Export is disabled: enter both From Date and To Date in Payment History.
  • Receipt is unavailable: verify that the invoice is Paid and the share token is valid. Allow newly confirmed payment data to update before retrying.
  • Invoice PDF fails: check that the invoice's encrypted metadata is available and your access is valid.
  • Withdraw is disabled: configure a withdrawal address in Settings and enter an amount within your balance. Complete the explicit wallet signature after confirmation.

See Export data and Withdraw funds.

When asking for help#

Include the invoice ID, network, action attempted, exact error message, and transaction hash if available. Do not include API keys, login codes, private keys, or the token from a full share link in a public report.

If you are looking for a feature rather than resolving an error, check known limitations for planned and unavailable functionality.