---
agentTools:
  projectIndex: https://docs.mundipagg.com/llms.txt
---

# Transferência bancária

Para criar uma [cobrança](https://docs.mundipagg.com/v1/reference#criar-cobranca) ou um [pedido](https://docs.mundipagg.com/v1/reference#criar-pedido) com **transferência bancária**, devemos incluir a propriedade `"payment_method": "bank_transfer"` dentro do nó `payment`, e caso necessário o objeto `bank_transfer`. O objeto `bank_transfer` tem as seguintes propriedades:

[block:parameters]
{
  "data": {
    "0-0": "`bank`",
    "0-1": "**string**",
    "1-0": "`metadata`",
    "1-1": "**object**",
    "2-0": "`gateway_affiliation_id`",
    "2-1": "**string**",
    "3-0": "`metadata`",
    "3-1": "**object**",
    "4-0": "`recurrence`",
    "4-1": "**boolean**",
    "5-0": "`metadata`",
    "5-1": "**object**",
    "0-2": "_Código do Banco_. `001` (Banco do Brasil); `237` (Bradesco) e `341` (Itau).",
    "1-2": "_Objeto chave/valor utilizado para armazenar informações adicionais sobre o pagamento_.[Saiba mais sobre metadata](https://docs.mundipagg.com/v1/reference#metadata).",
    "2-2": "Código de afiliação no gateway.",
    "3-2": "Objeto chave/valor utilizado para armazenar informações adicionais sobre o pagamento.",
    "4-2": "Indica se é uma cobrança/pedido de recorrência. O padrão é **false**",
    "5-2": "Objeto chave/valor utilizado para armazenar informações adicionais sobre o pagamento.\n\nOBS: Chave \"mundipagg_payment_method_code\" poderá ser utilizada para  informar o código da adquirente - com o objetivo de indicar em qual adquirente será processado o pagamento.",
    "h-0": "Atributos",
    "h-1": "Tipo",
    "h-2": "Descrição"
  },
  "cols": 3,
  "rows": 2
}
[/block]

[block:callout]
{
  "type": "info",
  "body": "Você pode configurar um código padrão para a sua loja. Desta forma, você não precisa enviá-lo em toda requisição e o nó `bank_transfer` sendo o mesmo opcional.",
  "title": "Código do Banco padrão"
}
[/block]

[block:code]
{
  "codes": [
    {
      "code": "{\n  \"amount\": 1490000,\n  \"customer\": {\n    \"name\": \"Tony Stark\",\n    \"email\": \"avengerstark@ligadajustica.com.br\",\n  \"document\": \"57510831563\",\n  \"type\": \"individual\"\n  },\n  \"payment\":{\n    \"metadata\":{\n\t     \"code\": \"3\"  \n   },\n    \"payment_method\": \"bank_transfer\",\n    \"bank_transfer\":{\n    \t\"bank\": 001\n    }\n  },\n  \"metadata\": {\n    \"code\": \"123\"\n  }\n}",
      "language": "json",
      "name": "Request Transferência entre contas (Cobrança)"
    },
    {
      "code": "{\n    \"id\": \"ch_j2bkebpurbCgEGpq\",\n    \"code\": \"0X7JFVQSN0\",\n    \"gateway_id\": \"364b6d2e-62e9-4fed-8646-3af3320d153b\",\n    \"amount\": 1490000,\n    \"status\": \"pending\",\n    \"currency\": \"BRL\",\n    \"payment_method\": \"bank_transfer\",\n    \"created_at\": \"2017-07-05T16:52:36Z\",\n    \"updated_at\": \"2017-07-05T16:52:36Z\",\n    \"customer\": {\n        \"id\": \"cus_1rp2jAES3RCwnyz0\",\n        \"name\": \"Tony Stark\",\n        \"email\": \"974169e4-9f6c-42ef-8355-a82a4ef4c388@avengers.com\",\n        \"document\": \"57510831563\",\n        \"type\": \"individual\",\n        \"delinquent\": false,\n        \"created_at\": \"2017-07-05T16:52:36Z\",\n        \"updated_at\": \"2017-07-05T16:52:36Z\",\n        \"phones\": {}\n    },\n    \"last_transaction\": {\n        \"url\": \"https://onlinedebitsandbox.mundipaggone.com:4443/OnlineDebit/Checkout/e17a8b29-857a-4087-8d27-4c0ab4e2e08b\",\n        \"bank_tid\": \"00000427\",\n        \"bank\": \"341\",\n        \"id\": \"tran_kEnJLNRH2sBLdBpW\",\n        \"transaction_type\": \"bank_transfer\",\n        \"gateway_id\": \"e17a8b29-857a-4087-8d27-4c0ab4e2e98b\",\n        \"amount\": 1490000,\n        \"status\": \"pending\",\n        \"success\": true,\n        \"created_at\": \"2017-07-05T16:52:36Z\",\n        \"updated_at\": \"2017-07-05T16:52:36Z\",\n        \"gateway_response\": {\n            \"code\": \"201\"\n        }\n    },\n    \"metadata\": {\n        \"code\": \"123\"\n    }\n}",
      "language": "json",
      "name": "Response Transferência entre contas (Cobrança)"
    },
    {
      "code": "package examples.order;\n\nimport com.mundipagg.api.MundiAPIClient;\nimport com.mundipagg.api.controllers.OrdersController;\nimport com.mundipagg.api.models.*;\nimport com.mundipagg.api.http.client.*;\n\nimport java.util.ArrayList;\n\npublic class CreateOrderBankTransfer {\n\t\n\tpublic static void main(String[] args) {\n\n        String basicAuthUserName = \"sk_test_4tdVXpseumRmqbo\"; // The username to use with basic authentication\n        String basicAuthPassword = \"\"; // The password to use with basic authentication\n\n        MundiAPIClient client = new MundiAPIClient(basicAuthUserName, basicAuthPassword);\n\n        OrdersController orders_controller = new OrdersController();\n\n        CreateCustomerRequest customer = new CreateCustomerRequest();\n        customer.setName(\"sdk customer order\");\n        customer.setEmail(\"tonystark@avengers.com\");\n\n        CreateBankTransferPaymentRequest create_bank_transfer_payment_request = new CreateBankTransferPaymentRequest();\n        create_bank_transfer_payment_request.setBank(\"001\");\n\n        CreateOrderRequest request = new CreateOrderRequest();\n\n        CreateOrderItemRequest orderItem = new CreateOrderItemRequest();\n        orderItem.setDescription(\"Tesseract Bracelet\");\n        orderItem.setQuantity(3);\n        orderItem.setAmount(1490);\n        ArrayList<CreateOrderItemRequest> listOrderItem = new ArrayList<CreateOrderItemRequest>();\n        listOrderItem.add(orderItem);\n        request.setItems(listOrderItem);\n\n        CreatePaymentRequest paymentItem = new CreatePaymentRequest();\n        paymentItem.setPaymentMethod(\"bank_transfer\");\n        paymentItem.setBankTransfer(create_bank_transfer_payment_request);\n        request.setCustomer(customer);\n        ArrayList<CreatePaymentRequest> lisPaymentItem = new ArrayList<CreatePaymentRequest>();\n        lisPaymentItem.add(paymentItem);\n        request.setPayments(lisPaymentItem);\n\n        orders_controller.createOrderAsync(request, new APICallBack<GetOrderResponse>() {\n            public void onSuccess(HttpContext context, GetOrderResponse response) {\n\n                System.out.println(\"Order bank transfer create !\");\n                System.out.println(\"Status response: \" + context.getResponse().getStatusCode());\n                System.out.println(\"Order result status: \" + response.getStatus());\n                System.out.println(\"Order id: \" + response.getId());\n\n            }\n\n            public void onFailure(HttpContext context, Throwable error) {\n\n                System.out.println(\"Status response: \" + context.getResponse().getStatusCode());\n                System.out.println(error.getMessage());\n                error.printStackTrace();\n\n            }\n        });\n    }\n\n}",
      "language": "java",
      "name": "SDK JAVA"
    }
  ]
}
[/block]

[block:api-header]
{
  "title": "Status das transações de Transferência Bancária (Transaction)"
}
[/block]

As transações de transferência bancária podem possuir os seguintes status:

[block:parameters]
{
  "data": {
    "h-0": "Status",
    "h-1": "Descrição",
    "0-0": "`pending`",
    "1-0": "`paid`",
    "2-0": "`overpaid`",
    "3-0": "`underpaid`",
    "4-0": "`with_error`",
    "5-0": "`not_paid`",
    "6-0": "`failed`",
    "0-1": "Pendente",
    "1-1": "Paga",
    "2-1": "Paga a maior",
    "3-1": "Paga a menor",
    "4-1": "Com erro",
    "5-1": "Não paga",
    "6-1": "Falha"
  },
  "cols": 2,
  "rows": 7
}
[/block]