--- title: "Criar recebedor contrato antigo" url: "https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5/operations/criar-recebedor-12" --- > Full API specification: https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5.md # Criar recebedor contrato antigo `POST` `/recipients1` Operation ID: `criar-recebedor-12` Rota para criar um recebedor, definindo os dados do recebedor, transferência e qual a conta bancária que será utilizada para envio dos pagamentos. ## Request body Content types: `application/json` ## Responses - `200` - 200 - `400` - 400 ## OpenAPI definition ```yaml openapi: 3.1.0 info: title: Pagar.me v5 API (Legado) version: 5.0.0 servers: - url: https://api.stone.com.br/core/v5 paths: /recipients1: post: summary: Criar recebedor contrato antigo description: Rota para criar um recebedor, definindo os dados do recebedor, transferência e qual a conta bancária que será utilizada para envio dos pagamentos. operationId: criar-recebedor-12 requestBody: content: application/json: schema: type: object required: - name - document - type properties: name: type: string description: Nome do recebedor. Max:128 caracteres email: type: string description: "E-mail do recebedor. Max: 64 caracteres" description: type: string description: Descrição do recebedor. Max:256 caracteres document: type: string description: "CPF ou CNPJ do recebedor. Max: 16 caracteres" type: type: string description: "Tipo de recebedor. Valores possíveis: **individual** (pessoa física) ou **company** (pessoa jurídica)" code: type: string description: Referencia externa única por recebedor default_bank_account: properties: holder_name: type: string description: "Nome da conta. Max: 30 caracteres" bank: type: string description: Código do banco. Max 3 caracteres numéricos branch_number: type: string description: Número da agência. Max 4 caracteres branch_check_digit: type: string description: "Digito validador da agência. Max: 1 caracter numérico" account_number: type: string description: "Número da conta. Max: 13 caracteres numéricos" account_check_digit: type: string description: Digitos validadores da conta. Max 2 caracteres numéricos holder_type: type: string description: Tipo do documento. "individual" ou "company" holder_document: type: string description: Número do documento do titular da conta. Deve ser igual ao documento do recebedor. Somente números type: type: string description: 'Tipo da conta. Valores Possiveis: "checking" ou "savings"' required: - holder_name - bank - branch_number - account_number - account_check_digit - holder_type - holder_document - type type: object description: Dados da conta bancária do recebedor. transfer_settings: properties: transfer_enabled: type: boolean description: Indica se o recebedor receberá seus pagamentos automaticamente. transfer_interval: type: string description: 'Indica a frequência das transferências automáticas para a conta do recebedor. Valores possíveis: "Daily", "Weekly" ou "Monthly".' transfer_day: type: integer description: Indica o dia em que ocorrerá as transferências automáticas. format: int32 required: [] type: object description: Informações de transferência do recebedor automatic_anticipation_settings: properties: enabled: type: boolean description: Indica se o recebedor receberá antecipações automaticamente type: type: string description: Indica o tipo de antecipação automática que será configurado para a conta do recebedor. Valores possíveis "full" e "1025" volume_percentage: type: string description: Indica a porcentagem do volume passível de ser antecipado para o recebedor. delay: type: string description: Indica a quantidade de dias que serão desconsiderados na contabilização do valor passível de ser antecipado. A contagem de dias é realizada a partir do dia da antecipação para trás required: [] type: object description: Informações de antecipação automática do recebedor metadata: type: string description: Objeto chave/valor utilizado para armazenar informações adicionais sobre o recebedor. examples: Request Example: value: name: Teste campos email: tstark@avengers.com description: Recebedor tony stark document: "26224451990" type: individual default_bank_account: holder_name: Tony Stark holder_type: individual holder_document: "26224451990" bank: "341" branch_number: "1234" branch_check_digit: "6" account_number: "12345" account_check_digit: "6" type: checking metadata: key: value transfer_settings: transfer_enabled: false transfer_interval: Daily transfer_day: 0 automatic_anticipation_settings: enabled: true type: full volume_percentage: "50" delay: null metadata: key: value responses: "200": description: "200" content: application/json: examples: Result: value: |- { "id": "rp_P6b2aBqtPsbwG7xw", "name": "Tony Stark", "email": "tstark@avengers.com", "document": "26224451990", "description": "Recebedor tony stark", "type": "individual", "status": "active", "created_at": "2017-08-03T20:29:28Z", "updated_at": "2017-08-03T20:29:28Z", "transfer_settings": { "transfer_enabled": false, "transfer_interval": "Daily", "transfer_day": 0 }, "default_bank_account": { "id": "ba_Ez2lE71FBUPa3XZK", "holder_name": "Tony Stark", "holder_type": "individual", "holder_document": "26224451990", "bank": "341", "branch_number": "1234", "branch_check_digit": "6", "account_number": "12345", "account_check_digit": "6", "type": "checking", "status": "active", "created_at": "2017-08-03T20:29:28Z", "updated_at": "2017-08-03T20:29:28Z", "metadata": { "key": "value" } }, "gateway_recipients": [ { "gateway": "pagarme", "status": "active", "pgid": "re_cj5aaa5i000cdhj6ernz14j1i", "createdAt": "2017-08-03T20:29:28Z", "updatedAt": "2017-08-03T20:29:28Z" } ], "automatic_anticipation_settings": { "enabled": true, "type": "full", "volume_percentage": 50, "delay": 365 }, "metadata": { "key": "value" } } schema: type: object properties: id: type: string example: rp_P6b2aBqtPsbwG7xw name: type: string example: Tony Stark email: type: string example: tstark@avengers.com document: type: string example: "26224451990" description: type: string example: Recebedor tony stark type: type: string example: individual status: type: string example: active created_at: type: string example: 2017-08-03T20:29:28Z updated_at: type: string example: 2017-08-03T20:29:28Z transfer_settings: type: object properties: transfer_enabled: type: boolean example: false default: true transfer_interval: type: string example: Daily transfer_day: type: integer example: 0 default: 0 default_bank_account: type: object properties: id: type: string example: ba_Ez2lE71FBUPa3XZK holder_name: type: string example: Tony Stark holder_type: type: string example: individual holder_document: type: string example: "26224451990" bank: type: string example: "341" branch_number: type: string example: "1234" 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: 2017-08-03T20:29:28Z updated_at: type: string example: 2017-08-03T20:29:28Z metadata: type: object properties: key: type: string example: value gateway_recipients: type: array items: type: object properties: gateway: type: string example: pagarme status: type: string example: active pgid: type: string example: re_cj5aaa5i000cdhj6ernz14j1i createdAt: type: string example: 2017-08-03T20:29:28Z updatedAt: type: string example: 2017-08-03T20:29:28Z automatic_anticipation_settings: type: object properties: enabled: type: boolean example: true default: true type: type: string example: full volume_percentage: type: integer example: 50 default: 0 delay: type: integer example: 365 default: 0 metadata: type: object properties: key: type: string example: value "400": description: "400" content: application/json: examples: Result: value: "{}" schema: type: object properties: {} deprecated: false security: - sec0: [] components: securitySchemes: sec0: type: http scheme: basic ```