iBaaS
  1. Aliases
iBaaS
  • iBaaS
    • v1
      • Authentication
        • login webhooks
        • login
        • refresh
        • logout
      • BaaS
        • Account
          • create-description
          • Occupations
            • list
          • retrieve-from-provider
            • by-account-number
            • by-account-id
          • migrate-account
            • import-csv
            • list-account-migrated
            • create-account-in-matera
            • list-account-migration-logs
            • cancel-account
          • create
          • update
          • search
          • find
          • find-by-account-number
          • find-by-tax-id-number
          • get-balance
          • get-statement
          • inactivate
          • get-file
        • Cash In
          • make-pix-static-qr-code
          • make-pix-dynamic-qr-code
          • make-bank-slip
          • make-billing-slip
          • make-deposit
        • Cash Out
          • make-pix-transfer
          • make-pix-transfer-only-with-alias
          • make-non-priority-pix-transfer
          • make-bank-transfer
          • make-bank-slip-payment
          • make-utilities-payment
          • make-internal-transfer
          • return-internal-transfer
        • Transactions
          • get-transaction
          • get-withdraw
          • get-bank-slip-by-bar-code
          • lock-balance
          • unlock-balance
          • initiate-ted
        • Pix
          • Aliases
            • Portabilidade de Alias (Chave)
            • list
              GET
            • exclude
              DELETE
            • create
              POST
            • alias-verification-code
              POST
            • get-destination-alias
              GET
            • alias-portability
              POST
            • alias-portability-confirmation
              POST
            • alias-portability-cancellation
              DELETE
            • alias-ownership-claims
              POST
            • alias-ownership-claims-responses
              POST
            • alias-ownership-claims-cancellation
              DELETE
          • Med
            • iBass
              • search
              • create
              • cancel
            • list
            • search
            • find
            • create
            • sent
            • in_analysis
            • approved
            • rejected
            • cancel
            • situation-types
            • med-types
            • med-status
          • Automatic
            • Recurrence
              • List Recurrences
              • Detail Recurrence
              • Authorize Recurrence
              • Save Recurrence With Authorization
            • Billing
              • Cancel Billing Scheduled
              • List Billings Scheduled
          • get-limits
            GET
          • return-codes
            GET
          • get-participants
            GET
          • returns
            POST
          • decode-qr-code
            POST
          • text-to-qr-code
            POST
        • Cellphone Recharge
          • get-carriers
          • get-avaliable-values
          • recharge
        • Webhook
          • set-accounts-webhook
        • Limits
          • get-limits
          • request-limit-update
          • search-update-limit-requests
          • process-limit-update
        • Batches and Billings
          • Charge Report
            • generate-pdf
            • search
          • billing-slip-payers
            • search-by
            • list
            • create
            • find
            • update
            • delete
            • search
          • validate-shipment
          • shipment_file
          • send-shipment-with-json
          • download-return-file-batch-id
          • download-return-file-period
          • get-batches
          • get-batch
          • get-billings
          • get-billing
        • receipt-of-bills
          • Mudar status boleto (dev)
        • Dock
          • Catalog
            • document
          • Onboarding
            • setup-types
            • schema-and-business
            • product-processes
            • update-account
            • reg-docs
            • agree-reg-docs
            • start-instance
            • file-upload
            • pending-files
            • customer-process
            • client-proposal
            • Endpoint Sem Título
          • Account
            • get-account
            • update-status
            • list-account-entries
          • Account Manager
            • list-alias-via-account-identifier
            • create-banking-account
            • delete-banking-account
          • Pay
            • search-transfers
            • get-transfer
            • initiate-transfer
            • cancel-scheduled-transfer
          • Pix
            • create-dict-key
            • search-dicts
            • search-payments
            • send-payment
            • validate-dict
            • delete-dict-key
            • get-payment
      • Public Routers
        • validate-cnab400
  • Enums
    • PhysicalBusinessLineEnum
    • LegalBusinessLIneEnum
    • EstablishmentFormEnum
    • FinancialStatisticEnum
    • CountryEnum
    • AccountStatusEnum
    • DocumentsTypeEnum
    • MaritalStatusEnum
    • TestDataTableForPaymentSlips
    • CollectionWalletEnum
    • FineCodeEnum
    • RegistrationTypeEnum
    • Boletos
      • BillingSlipOriginTypeEnum
      • BatchBillingSlipFileTypeEnum
      • BillingSlipStatusEnum
      • OccurrenceCodeEnum
      • TitleTypeEnum
  • Esquemas
    • External Events
      • BaaS Dock
    • Ramos de Atividade
  1. Aliases

Portabilidade de Alias (Chave)

Portabilidade de chave PIX#

Existem dois caminhos para realização da portabilidade da chave PIX, sendo eles o inter psp e intra psp.

Portabilidade intra psp#

A portabilidade intra psp é quando o cliente deseja transferir uma chave pix para outra conta que utiliza o mesmo participante, por exemplo, transferir uma chave de uma conta Inovanti para outra conta Inovanti.
Para tal, se utiliza-se dos endpoints alias-ownership-*, como veremos a seguir.
1
Criação de chave
A conta que receberá a transferência de chave deve cria-la, por meio do endpoint POST /v1/baas/pix/{account_id}/aliases e o identificador do protocolo será retornado, no campo protocol_id.
Com isso, a chave irá para o status IDENTITY_VALIDATION_PENDING.
2
Validação de código
Um código de verificação será enviado via email ou telefone, de acordo com o tipo da chave. Você deverá utilizar o endpoint POST /v1/baas/pix/{account_id}/aliases/{alias}/opt-validation, informando o protocol_id e o código recebido.
Nesse momento, a chave irá para o status PENDING_CLAIM_CONFIRMATION.
3
Reivindicação de posse
Agora com a chave validada, é necessário realizar a reivindicação de posse, utilizando o endpoint POST /v1/baas/pix/{account_id}/aliases/{alias}/ownership/claims, enviando confirm: true e a razão (campo reason) que a reivindicação está sendo realizada, com as seguintes possibilidades: FRAUD, USER_REQUESTED, ACCOUNT_CLOSURE.
Se tudo ocorrer certo, a chave deve ir para o status CLAIM_AWAITTING_RETURN_PSP_DONOR.
4
Doação
Nesse passo, a conta que doará a chave deve utilizar o endpoint POST /v1/baas/pix/{account_id}/aliases/{alias}/ownership/claims/responses, enviando confirm: false e a conta deve ir para o status PENDING_VALIDATION_COMPLETE_CLAIM.
5
2º Reivindicação de posse
Agora que a doação foi confirmada, é necessário realizar novamente a reivindicação de posse, utilizando o endpoint POST /v1/baas/pix/{account_id}/aliases/{alias}/ownership/claims, enviando confirm: true e a mesma razão (campo reason) enviada anteriormente.
Se tudo ocorrer certo, um protocol_id será retornado e um novo token será enviado.
6
2º Validação de código
Um código de verificação será enviado via email ou telefone, de acordo com o tipo da chave. Você deverá utilizar o endpoint POST /v1/baas/pix/{account_id}/aliases/{alias}/opt-validation, informando o protocol_id e o código recebido.
Nesse momento, a chave irá para o status ACTIVE e a operação foi concluida.

Portabilidade inter psp#

A portabilidade inter psp é quando o cliente deseja transferir uma chave pix para outra conta que utiliza um participante diferente, por exemplo, transferir uma chave de uma conta Inovanti para uma conta de outro banco.
Para tal, se utiliza-se dos endpoints alias-portability-*, como veremos a seguir.
1
Criação de chave
A conta que receberá a transferência de chave deve cria-la, por meio do endpoint POST /v1/baas/pix/{account_id}/aliases e o identificador do protocolo será retornado, no campo protocol_id.
Com isso, a chave irá para o status IDENTITY_VALIDATION_PENDING.
2
Validação de código
Um código de verificação será enviado via email ou telefone, de acordo com o tipo da chave. Você deverá utilizar o endpoint POST /v1/baas/pix/{account_id}/aliases/{alias}/opt-validation, informando o protocol_id e o código recebido.
Nesse momento, a chave irá para o status PENDING_PORTABILITY_CONFIRMATION.
3
Solicitação de portabilidade
Agora com a chave validada, é necessário realizar a rsolicitação de portabilidade, utilizando o endpoint POST /v1/baas/pix/{account_id}/aliases/{alias}/portability, enviando confirm: true.
Se tudo ocorrer certo, a chave deve ir para o status AWAITING_RETURN_PSP_DONOR e a confirmação deve ser realizada no banco de origem.
4
Confirmação
Se o processo for o contrário (chave saindo da Inovanti e indo para outro banco) a confirmação deve ser realizada, por meio do endpoint POST /v1/baas/pix/{account_id}/aliases/{alias}/portability/confirmation, enviando confirm: true para confirmar, e confirm: false para negar a solicitação.
Página anterior
Aliases
Próxima página
list
Built with