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 header | Obrigatoriedade | descrição | Formato | Exemplo |
---|---|---|---|---|
x-idempotence-key | Opcional | Chave de idempotencia da transação para garantir unicidade | UUIDv4 | gg3a31d3-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:
Campo | Tipo | Descriçã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 |
Updated 8 months ago