Criar Transferência

POST

/api/user/transfers

Este endpoint permite realizar uma transferência de valores para uma conta previamente cadastrada por um recebedor autenticado.
A transferência pode ser feita via PIX ou Transferência Bancária (BANK_TRANSFER), dependendo do método especificado.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/user/transfers' \
--header 'x-api-key: {Token}' \
--header 'User-Agent: AtivoB2B/1.0' \
--header 'Content-Type: application/json' \
--data-raw '{
  "amount": 100,
  "method": "PIX"
}'

Response Example

200 - Success

{
    "message": "Transferência realizada com sucesso.",
    "data": {
        "transfer": [
            {
                "id": "********-****-****-****-************",
                "amount": 500,
                "type": "PIX",
                "status": "INPROCESS",
                "fee": 0,
                "externalRef": null,
                "pixKey": "*************",
                "paidAt": null,
                "typePayment": null,
                "refundedAmount": 0,
                "description": null,
                "receiptUrl": null,
                "endToEndId": null,
                "error": null,
                "payeeId": null,
                "sellerId": "********-****-****-****-************",
                "gatewayId": "********-****-****-****-************",
                "subAccountId": null,
                "createdAt": "2025-04-16T17:46:32.084Z",
                "updatedAt": "2025-04-16T17:46:32.135Z"
            }
        ]
    },
    "status": 200,
    "error": null
}

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Modified at 2025-08-15 20:37:16

Criar Transferência

Buscar Transferência por ID