Skip to main content

Unable to Link or Create a Pix Key

Daniela Martins avatar
Written by Daniela Martins
Updated over 2 weeks ago

If you are unable to create or link a Pix key in your AstroPay account, here 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.

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

  • Verify the information entered is correct and active.

  • If the issue persists, inform us and we’ll help you complete the process.

Did this answer your question?