Skip to main content

Why can't I link or create a PIX key?

Find out the most common reasons a PIX key fails to register or link, and how to resolve each one.

P
Written by Product

If you cannot create or link a Pix key in your AstroPay account, these are the most common reasons and how to solve them.

1. Key already registered elsewhere

  • Each Pix key (CPF, phone number, or email) can only be registered in one account at a time.

  • If the data is already in use in another bank or financial institution, you will need to request Pix key portability to transfer it to AstroPay.

How to request portability

  1. Try registering the Pix key in the AstroPay app.

  2. The app will recognize that the key is linked to another institution and start the portability process.

  3. The institution where the key is currently registered will send a confirmation request within 10 minutes.

  4. Once you confirm the request, the migration usually completes in 1 minute.

  5. You must confirm the portability request within 7 days; otherwise, it will be canceled and the key will remain with the previous institution.

2. Maximum key limit reached

  • Each user can register up to 5 Pix keys per account.

  • If you have already reached this limit, you will need to delete an existing key before registering a new one.

3. Incorrect or invalid data

  • Make sure the information you are trying to register (email, phone, or CPF) is valid and active.

  • For phone numbers, confirm the correct country code is included.

4. Temporary system issues

  • In rare cases, the registration may fail due to temporary issues with the Central Bank or with the institutions involved.

  • If this happens, wait a few minutes and try again.

Summary

  • Check if the key is already registered in another institution and request portability if so.

  • Confirm you haven't reached the 5-key limit.

  • Verify the information entered is correct and active.

  • If the registration fails due to a system issue, wait a few minutes and retry.

Did this answer your question?