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

# Cria saque

Rota para realizar o saque para uma **conta bancária**  de um **recebedor**.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Mundipagg API",
    "version": "1"
  },
  "servers": [
    {
      "url": "https://api.mundipagg.com/core/v1"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/recipients/recipient_id/withdrawals": {
      "post": {
        "summary": "Cria saque",
        "description": "Rota para realizar o saque para uma **conta bancária**  de um **recebedor**.",
        "operationId": "cria-saque",
        "parameters": [
          {
            "name": "recipient_id",
            "in": "path",
            "description": "Código do recebedor",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "amount": {
                    "type": "integer",
                    "description": "Valor da cobrança em centavos",
                    "format": "int32"
                  }
                }
              },
              "examples": {
                "Request Example": {
                  "value": {
                    "amount": 100
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n      \"id\": \"with_LJ0OkmVcJCVPj4Yp\",\n      \"amount\": 100,\n      \"status\": \"failed\",\n      \"created_at\": \"2020-01-16T16:36:39Z\",\n      \"updated_at\": \"2020-01-16T16:36:39Z\",\n      \"bank_account\": {\n        \"id\": \"ba_jGXwbQtNASZZrdpE\",\n        \"holder_name\": \"Second recipient\",\n        \"holder_type\": \"company\",\n        \"holder_document\": \"15313587000166\",\n        \"bank\": \"341\",\n        \"branch_number\": \"12345\",\n        \"branch_check_digit\": \"6\",\n        \"account_number\": \"12345\",\n        \"account_check_digit\": \"6\",\n        \"type\": \"checking\",\n        \"status\": \"active\",\n        \"created_at\": \"2020-01-02T20:23:17Z\",\n        \"updated_at\": \"2020-01-02T20:23:17Z\",\n        \"metadata\": {\n          \"meta_key\": \"meta_value\"\n        },\n        \"recipient\": {\n          \"id\": \"rp_yLnAyVpHbQIqZxwO\",\n          \"name\": \"Second recipient\",\n          \"email\": \"second_recipient@mundipagg.com\",\n          \"document\": \"15313587000166\",\n          \"description\": \"Descrição do recebedor 2\",\n          \"type\": \"company\",\n          \"status\": \"active\",\n          \"created_at\": \"2020-01-02T20:23:17Z\",\n          \"updated_at\": \"2020-01-02T20:23:17Z\"\n        }\n      }\n    }"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "example": "with_LJ0OkmVcJCVPj4Yp"
                    },
                    "amount": {
                      "type": "integer",
                      "example": 100,
                      "default": 0
                    },
                    "status": {
                      "type": "string",
                      "example": "failed"
                    },
                    "created_at": {
                      "type": "string",
                      "example": "2020-01-16T16:36:39Z"
                    },
                    "updated_at": {
                      "type": "string",
                      "example": "2020-01-16T16:36:39Z"
                    },
                    "bank_account": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "example": "ba_jGXwbQtNASZZrdpE"
                        },
                        "holder_name": {
                          "type": "string",
                          "example": "Second recipient"
                        },
                        "holder_type": {
                          "type": "string",
                          "example": "company"
                        },
                        "holder_document": {
                          "type": "string",
                          "example": "15313587000166"
                        },
                        "bank": {
                          "type": "string",
                          "example": "341"
                        },
                        "branch_number": {
                          "type": "string",
                          "example": "12345"
                        },
                        "branch_check_digit": {
                          "type": "string",
                          "example": "6"
                        },
                        "account_number": {
                          "type": "string",
                          "example": "12345"
                        },
                        "account_check_digit": {
                          "type": "string",
                          "example": "6"
                        },
                        "type": {
                          "type": "string",
                          "example": "checking"
                        },
                        "status": {
                          "type": "string",
                          "example": "active"
                        },
                        "created_at": {
                          "type": "string",
                          "example": "2020-01-02T20:23:17Z"
                        },
                        "updated_at": {
                          "type": "string",
                          "example": "2020-01-02T20:23:17Z"
                        },
                        "metadata": {
                          "type": "object",
                          "properties": {
                            "meta_key": {
                              "type": "string",
                              "example": "meta_value"
                            }
                          }
                        },
                        "recipient": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "example": "rp_yLnAyVpHbQIqZxwO"
                            },
                            "name": {
                              "type": "string",
                              "example": "Second recipient"
                            },
                            "email": {
                              "type": "string",
                              "example": "second_recipient@mundipagg.com"
                            },
                            "document": {
                              "type": "string",
                              "example": "15313587000166"
                            },
                            "description": {
                              "type": "string",
                              "example": "Descrição do recebedor 2"
                            },
                            "type": {
                              "type": "string",
                              "example": "company"
                            },
                            "status": {
                              "type": "string",
                              "example": "active"
                            },
                            "created_at": {
                              "type": "string",
                              "example": "2020-01-02T20:23:17Z"
                            },
                            "updated_at": {
                              "type": "string",
                              "example": "2020-01-02T20:23:17Z"
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": false
  },
  "x-readme-fauxas": true,
  "_id": "5aba89f6b169810058a71e9a:5e20959adc270c0485994d9c"
}
```