--- updatedAt: 2026-06-03T12:16:05.000Z agentTools: projectIndex: https://docs.asaas.com/llms.txt --- # Transfer to another Institution’s account or Pix key This endpoint is used to create outbound transfers to external accounts, either through TED or Pix, or directly to a Pix key. Use this call when your application needs to move funds from an Asaas account out of the platform, whether to a traditional bank account or straight to a Pix key. The transfer method depends on the data provided in the request: * If `bankAccount` is provided, the transfer will be made to a bank account * If `pixAddressKey` is provided, the transfer will be processed via Pix If `operationType` is not provided, the system automatically determines the transfer type: * Pix, if the destination institution is a Pix participant * TED, otherwise ## Main request parameters Some fields determine how the transfer will be processed: * **value**: Amount to be transferred. * **bankAccount**: Object containing the destination bank account details. This should be used when the transfer is not being made to a Pix key. * **operationType**: Defines the transfer method: * `PIX` * `TED` * If omitted, the type will be determined automatically. * **pixAddressKey**: Destination Pix key (`CPF`, `CNPJ`, email, phone number, or `EVP`). * **pixAddressKeyType**: Type of the Pix key provided: * `CPF` * `CNPJ` * `EMAIL` * `PHONE` * `EVP` * **description**: Transfer description. Available for Pix transfers. * **scheduleDate**: Scheduled transfer date. If not provided, the transfer is processed immediately. * **externalReference**: Identifier of the transfer in your own system. * **recurring**: Object that defines recurrence rules. Available only for Pix transfers. ## Transfer behavior Transfer processing varies depending on the transfer type: * **Pix** * Can be processed instantly or scheduled * Settlement happens in real time once processed * **TED** * Depends on banking hours and banking rules * May be processed on the same day or on the next business day After creation, the transfer may go through statuses such as: * `PENDING` * `DONE` * `CANCELLED` ## When to use Use this endpoint when you need to: * Transfer funds to external accounts * Make payments to third parties * Automate outbound financial disbursements outside Asaas # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Asaas", "description": "API pública de integração com a plataforma Asaas.", "version": "3.0.0" }, "servers": [ { "url": "https://api-sandbox.asaas.com", "description": "Sandbox" } ], "security": [ { "Authorization": [] } ], "tags": [ { "name": "Transfer" } ], "paths": { "/v3/transfers": { "post": { "tags": [ "Transfer" ], "summary": "Transfer to another Institution’s account or Pix key", "description": "", "operationId": "transfer-to-another-institution-account-or-pix-key", "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransferSaveRequestDTO" } } } }, "responses": { "200": { "description": "Ok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransferGetResponseDTO" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponseDTO" }, "example": { "errors": [ { "code": "error_code", "description": "Error description" } ] } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponseDTO" }, "example": { "errors": [ { "code": "invalid_access_token", "description": "A chave de API fornecida é inválida" } ] } } } } }, "deprecated": false } } }, "components": { "schemas": { "ErrorResponseDTO": { "type": "object", "properties": { "errors": { "type": "array", "description": "List of objects", "deprecated": false, "items": { "$ref": "#/components/schemas/ErrorResponseItemDTO" } } } }, "ErrorResponseItemDTO": { "type": "object", "properties": { "code": { "type": "string", "description": "Error code", "deprecated": false, "example": null }, "description": { "type": "string", "description": "Error description", "deprecated": false, "example": null } }, "description": "List of objects", "deprecated": false }, "TransferGetResponseDTO": { "type": "object", "properties": { "object": { "type": "string", "description": "Object type", "example": "transfer", "deprecated": false }, "id": { "type": "string", "description": "Unique transfer identifier in Asaas", "example": "777eb7c8-b1a2-4356-8fd8-a1b0644b5282", "deprecated": false }, "type": { "type": "string", "description": "Type of transfer", "example": "BANK_ACCOUNT", "deprecated": false, "enum": [ "PIX", "TED", "INTERNAL" ] }, "dateCreated": { "type": "string", "description": "Transfer request date", "format": "date", "example": "2019-05-02", "deprecated": false }, "value": { "type": "number", "description": "Transfer amount", "example": 1000, "deprecated": false }, "netValue": { "type": "number", "description": "Net value minus transfer fee", "example": 0, "deprecated": false }, "status": { "$ref": "#/components/schemas/TransferGetResponseTransferStatus" }, "transferFee": { "type": "number", "description": "Transfer rate", "example": 0, "deprecated": false }, "effectiveDate": { "type": "string", "description": "Effective date", "format": "date", "example": "2019-05-02", "deprecated": false }, "scheduleDate": { "type": "string", "description": "Schedule date", "format": "date", "example": "2019-05-02", "deprecated": false }, "endToEndIdentifier": { "type": "string", "description": "Unique identifier of the Pix transaction at the Central Bank", "deprecated": false, "example": null }, "authorized": { "type": "boolean", "description": "`false` when awaiting authorization via SMS Token", "example": true, "deprecated": false }, "failReason": { "type": "string", "description": "Reason for transfer failure", "deprecated": false, "example": null }, "externalReference": { "type": "string", "description": "Transfer identifier in your system", "deprecated": false, "example": null }, "transactionReceiptUrl": { "type": "string", "description": "Proof of transfer will be available after the transfer is confirmed", "deprecated": false, "example": null }, "operationType": { "$ref": "#/components/schemas/TransferGetResponseTransferType" }, "description": { "type": "string", "description": "Transfer description", "deprecated": false, "example": null }, "recurring": { "type": "string", "description": "Unique recurrence identifier in Asaas", "deprecated": false, "example": null }, "bankAccount": { "$ref": "#/components/schemas/TransferBankAccountGetResponseDTO" } } }, "TransferGetResponseTransferStatus": { "type": "string", "description": "Transfer status", "example": "PENDING", "deprecated": false, "enum": [ "PENDING", "BANK_PROCESSING", "DONE", "CANCELLED", "FAILED" ] }, "TransferGetResponseTransferType": { "type": "string", "description": "Transfer method", "example": "TED", "deprecated": false, "enum": [ "PIX", "TED", "INTERNAL" ] }, "TransferBankAccountGetResponseDTO": { "type": "object", "properties": { "bank": { "$ref": "#/components/schemas/TransferBankGetResponseDTO" }, "accountName": { "type": "string", "description": "Name of bank account owner", "example": "Banco do Brasil account", "deprecated": false }, "ownerName": { "type": "string", "description": "Name of bank account owner", "example": "John Doe", "deprecated": false }, "cpfCnpj": { "type": "string", "description": "CPF or CNPJ of the bank account owner", "example": "***.143.689-**", "deprecated": false }, "agency": { "type": "string", "description": "Non-digit agency number", "example": "1263", "deprecated": false }, "agencyDigit": { "type": "string", "description": "Agency digit", "example": "3", "deprecated": false }, "account": { "type": "string", "description": "Non-digit bank account number", "example": "9999991", "deprecated": false }, "accountDigit": { "type": "string", "description": "Bank account digit", "example": "1", "deprecated": false }, "pixAddressKey": { "type": "string", "description": "Pix key address", "deprecated": false, "example": null } }, "description": "Bank account details", "deprecated": false }, "TransferBankGetResponseDTO": { "type": "object", "properties": { "ispb": { "type": "string", "description": "Identifier in the Brazilian Payment System", "deprecated": false, "example": null }, "code": { "type": "string", "description": "Bank clearing code in the banking system", "example": "001", "deprecated": false }, "name": { "type": "string", "description": "Bank name", "example": "Banco do Brasil", "deprecated": false } }, "description": "Bank account name", "deprecated": false }, "TransferSaveRequestDTO": { "required": [ "value" ], "type": "object", "properties": { "value": { "type": "number", "description": "Amount to be transferred", "nullable": false, "example": 1000, "deprecated": false }, "bankAccount": { "$ref": "#/components/schemas/TransferBankAccountSaveRequestDTO" }, "operationType": { "$ref": "#/components/schemas/TransferSaveRequestTransferType" }, "pixAddressKey": { "type": "string", "description": "Enter the Pix key if it is a transfer to a Pix key", "deprecated": false, "example": null }, "pixAddressKeyType": { "$ref": "#/components/schemas/TransferSaveRequestPixAddressKeyType" }, "description": { "type": "string", "description": "Transfers via Pix allow description", "example": "Barbecue paid via Pix scheduled", "deprecated": false }, "scheduleDate": { "type": "string", "description": "For scheduled transfers, if not informed, payment is instantaneous", "format": "date", "example": "2018-01-26", "deprecated": false }, "externalReference": { "type": "string", "description": "Transfer identifier in your system", "deprecated": false, "example": null }, "recurring": { "$ref": "#/components/schemas/TransferRecurringSaveRequestDTO" } } }, "TransferBankAccountSaveRequestDTO": { "required": [ "ownerName", "cpfCnpj", "agency", "account", "accountDigit" ], "type": "object", "properties": { "bank": { "$ref": "#/components/schemas/TransferBankSaveRequestDTO" }, "accountName": { "type": "string", "description": "Bank account name", "example": "Bradesco account", "deprecated": false }, "ownerName": { "type": "string", "description": "Name of bank account owner", "nullable": false, "example": "John Doe", "deprecated": false }, "ownerBirthDate": { "type": "string", "description": "Account owner's date of birth. Only when the bank account does not belong to the same CPF or CNPJ as the Asaas account.", "format": "date", "example": "1995-04-12", "deprecated": false }, "cpfCnpj": { "type": "string", "description": "CPF or CNPJ of the bank account owner", "nullable": false, "example": "52233424611", "deprecated": false }, "agency": { "type": "string", "description": "Non-digit agency number", "nullable": false, "example": "1263", "deprecated": false }, "account": { "type": "string", "description": "Non-digit bank account number", "nullable": false, "example": "9999991", "deprecated": false }, "accountDigit": { "type": "string", "description": "Bank account digit", "nullable": false, "example": "1", "deprecated": false }, "bankAccountType": { "$ref": "#/components/schemas/TransferBankAccountSaveRequestBankAccountType" }, "ispb": { "type": "string", "description": "Identifier in the Brazilian Payment System", "example": "60746948", "deprecated": false } }, "description": "Enter your account details if it is a transfer to a bank account", "deprecated": false }, "TransferBankSaveRequestDTO": { "required": [ "code" ], "type": "object", "properties": { "code": { "type": "string", "description": "Bank clearing code in the banking system", "nullable": false, "example": "237", "deprecated": false } }, "description": "Details of the bank account to which the transfer will be made", "deprecated": false }, "TransferBankAccountSaveRequestBankAccountType": { "type": "string", "description": "Account type", "example": "CONTA_CORRENTE", "deprecated": false, "enum": [ "CONTA_CORRENTE", "CONTA_POUPANCA" ] }, "TransferSaveRequestTransferType": { "type": "string", "description": "Transfer modality. If not informed and the receiving institution is a Pix participant, the transfer is via Pix. Otherwise via TED.", "example": "PIX", "deprecated": false, "enum": [ "PIX", "TED" ] }, "TransferSaveRequestPixAddressKeyType": { "type": "string", "description": "Enter the type of key if it is a transfer to a Pix key", "example": "EVP", "deprecated": false, "enum": [ "CPF", "CNPJ", "EMAIL", "PHONE", "EVP" ] }, "TransferRecurringSaveRequestDTO": { "type": "object", "properties": { "frequency": { "$ref": "#/components/schemas/TransferRecurringSaveRequestRecurringCheckoutScheduleFrequency" }, "quantity": { "maximum": 51, "minimum": 1, "type": "integer", "description": "Number of repetitions. This transfer will be included as the first transaction of the recurrence.\n For the `WEEKLY` frequency, the maximum accepted is: `51`\n For the `MONTHLY` frequency, the maximum accepted is: `11`", "format": "int32", "example": 3, "deprecated": false } }, "description": "Recurrence information. Only for Pix transfers", "deprecated": false }, "TransferRecurringSaveRequestRecurringCheckoutScheduleFrequency": { "type": "string", "description": "Frequency", "example": "MONTHLY", "deprecated": false, "enum": [ "WEEKLY", "MONTHLY" ] } }, "securitySchemes": { "Authorization": { "type": "apiKey", "name": "access_token", "in": "header" } } }, "x-readme": { "headers": [ { "key": "User-Agent", "value": "NomeDaSuaAplicacao/1.0.0" } ] } } ``` # Sibling pages * [List transfers](https://docs.asaas.com/reference/list-transfers.md) * [Transfer to Asaas account](https://docs.asaas.com/reference/transfer-to-asaas-account-1.md) * [Retrieve a single transfer](https://docs.asaas.com/reference/retrieve-a-single-transfer.md) * [Cancel a transfer](https://docs.asaas.com/reference/cancel-a-transfer.md)