P2P - Transferências entre wallets

Transferência de valores entre wallets internas

Esta documentação tem como objetivo fornecer uma visão geral detalhada da funcionalidade de transferências P2P entre wallets internas. Esta funcionalidade permite que os usuários transfiram fundos de uma carteira para outra dentro do nosso sistema de forma direta e rápida.

Usado para:

  • Facilitar a transferência de fundos entre wallets de um mesmo cliente, de forma segura e eficiente.
  • Redução de tempo e esforço na transferência de fundos entre usuários.
  • Além de maior conveniência para os usuários que desejam transferir fundos dentro da plataforma.
  • Aumento da segurança, eliminando a necessidade de transferências externas.

Como fazer uma transferência P2P

ENDPOINT: https://kaizen.bt-staging.app/wallet-service/p2p

Esse endpoint utiliza o método POST.

Endpoint:

curl --location 'https://kaizen.bt-staging.app/wallet-service/p2p' \
--header 'x-idempotence-key: UUID' \
--header 'Authorization: Bearer TOKEN' \
--header 'Content-Type: application/json' \
--data '{
    "amount": "1",
    "source": "ddubfcd1-d094-4136-a908-ee489e694c6e",
    "destination": "f0887bd7-64bb-4354-a7f3-5819a8388769",
}'

Modelo de requisição:

Header da requisição:

O uso do Headers abaixo é opcional durante a execução do P2P. No entanto, caso não seja fornecido, será automaticamente gerado "idempotenceKey" no seguinte formato:

parâmetro do headerObrigatoriedadedescriçãoFormatoExemplo
x-idempotence-keyOpcionalChave de idempotencia da transação para garantir unicidadeUUIDv4gg3a31d3-e598-40a0-a795-c5f95b1ae5d9

Body de requisição:

{
    "amount": "0.01",
    "source": "297755a54-5252-40b7-927f-44a9ed7f52ad",
    "destination": "e545e09f-157e-429f-9366-77ac44e603e7",
    "additionalData": {
        "info": "Teste deploy 21-03-24"
    }
}

Body de resposta:

{
    "status": "executed",
    "transactionId": "345eae98-54af-47a4-ac35-34ebe0fdb807",
    "amount": "0.01",
    "source": "89955a54-5252-40b7-927f-44a9ed7f52ad",
    "destination": "ufg2e09f-157e-429f-9366-77ac44e603e7",
    "additionalData": {
        "info": "Teste"
    }
}

Descrição dos campos:

CampoTipoDescrição
"status"ENUM- status da transação
"source"string- wallet ID origem
"destination"string- wallet ID destino
"transactionId"string(uuid)- ID da transação gerada
"additionalData"string(72)- descrição do P2P