Criar Recebedor

curl --request POST \
  --url https://pay.autorizou.dev/api/v1/recipients \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "external_reference": "<string>",
  "email": "<string>",
  "legal_name": "<string>",
  "trade_name": "<string>",
  "status": "<string>",
  "type": "<string>",
  "company_type": "<string>",
  "name": "<string>",
  "birthday": "<string>",
  "founding_date": "<string>",
  "document": {
    "document.type": "<string>",
    "document.value": "<string>"
  },
  "phone": {
    "phone.type": "<string>",
    "phone.ddi": "<string>",
    "phone.ddd": "<string>",
    "phone.number": "<string>"
  },
  "address": {
    "address.type": "<string>",
    "address.line_1": "<string>",
    "address.number": "<string>",
    "address.line_2": "<string>",
    "address.neighborhood": "<string>",
    "address.city": "<string>",
    "address.state": "<string>",
    "address.postal_code": "<string>",
    "address.country": "<string>"
  },
  "managing_partners": [
    {
      "managing_partners[].name": "<string>",
      "managing_partners[].email": "<string>",
      "managing_partners[].document": "<string>",
      "managing_partners[].birthday": "<string>",
      "managing_partners[].nationality": "<string>",
      "managing_partners[].type": "<string>",
      "managing_partners[].role_description": "<string>",
      "managing_partners[].phone": {
        "managing_partners[].phone.type": "<string>",
        "managing_partners[].phone.ddd": "<string>",
        "managing_partners[].phone.number": "<string>"
      }
    }
  ],
  "bank_account": {
    "bank_account.bank_ispb": "<string>",
    "bank_account.holder_name": "<string>",
    "bank_account.branch_number": "<string>",
    "bank_account.branch_check_digit": "<string>",
    "bank_account.account_number": "<string>",
    "bank_account.account_check_digit": "<string>",
    "bank_account.pix_key": "<string>",
    "bank_account.pix_key_type": "<string>",
    "bank_account.status": "<string>",
    "bank_account.receiver_type": "<string>"
  },
  "metadata": {}
}
'

import requests

url = "https://pay.autorizou.dev/api/v1/recipients"

payload = {
    "external_reference": "<string>",
    "email": "<string>",
    "legal_name": "<string>",
    "trade_name": "<string>",
    "status": "<string>",
    "type": "<string>",
    "company_type": "<string>",
    "name": "<string>",
    "birthday": "<string>",
    "founding_date": "<string>",
    "document": {
        "document.type": "<string>",
        "document.value": "<string>"
    },
    "phone": {
        "phone.type": "<string>",
        "phone.ddi": "<string>",
        "phone.ddd": "<string>",
        "phone.number": "<string>"
    },
    "address": {
        "address.type": "<string>",
        "address.line_1": "<string>",
        "address.number": "<string>",
        "address.line_2": "<string>",
        "address.neighborhood": "<string>",
        "address.city": "<string>",
        "address.state": "<string>",
        "address.postal_code": "<string>",
        "address.country": "<string>"
    },
    "managing_partners": [
        {
            "managing_partners[].name": "<string>",
            "managing_partners[].email": "<string>",
            "managing_partners[].document": "<string>",
            "managing_partners[].birthday": "<string>",
            "managing_partners[].nationality": "<string>",
            "managing_partners[].type": "<string>",
            "managing_partners[].role_description": "<string>",
            "managing_partners[].phone": {
                "managing_partners[].phone.type": "<string>",
                "managing_partners[].phone.ddd": "<string>",
                "managing_partners[].phone.number": "<string>"
            }
        }
    ],
    "bank_account": {
        "bank_account.bank_ispb": "<string>",
        "bank_account.holder_name": "<string>",
        "bank_account.branch_number": "<string>",
        "bank_account.branch_check_digit": "<string>",
        "bank_account.account_number": "<string>",
        "bank_account.account_check_digit": "<string>",
        "bank_account.pix_key": "<string>",
        "bank_account.pix_key_type": "<string>",
        "bank_account.status": "<string>",
        "bank_account.receiver_type": "<string>"
    },
    "metadata": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    external_reference: '<string>',
    email: '<string>',
    legal_name: '<string>',
    trade_name: '<string>',
    status: '<string>',
    type: '<string>',
    company_type: '<string>',
    name: '<string>',
    birthday: '<string>',
    founding_date: '<string>',
    document: {'document.type': '<string>', 'document.value': '<string>'},
    phone: {
      'phone.type': '<string>',
      'phone.ddi': '<string>',
      'phone.ddd': '<string>',
      'phone.number': '<string>'
    },
    address: {
      'address.type': '<string>',
      'address.line_1': '<string>',
      'address.number': '<string>',
      'address.line_2': '<string>',
      'address.neighborhood': '<string>',
      'address.city': '<string>',
      'address.state': '<string>',
      'address.postal_code': '<string>',
      'address.country': '<string>'
    },
    managing_partners: [
      {
        'managing_partners[].name': '<string>',
        'managing_partners[].email': '<string>',
        'managing_partners[].document': '<string>',
        'managing_partners[].birthday': '<string>',
        'managing_partners[].nationality': '<string>',
        'managing_partners[].type': '<string>',
        'managing_partners[].role_description': '<string>',
        'managing_partners[].phone': {
          'managing_partners[].phone.type': '<string>',
          'managing_partners[].phone.ddd': '<string>',
          'managing_partners[].phone.number': '<string>'
        }
      }
    ],
    bank_account: {
      'bank_account.bank_ispb': '<string>',
      'bank_account.holder_name': '<string>',
      'bank_account.branch_number': '<string>',
      'bank_account.branch_check_digit': '<string>',
      'bank_account.account_number': '<string>',
      'bank_account.account_check_digit': '<string>',
      'bank_account.pix_key': '<string>',
      'bank_account.pix_key_type': '<string>',
      'bank_account.status': '<string>',
      'bank_account.receiver_type': '<string>'
    },
    metadata: {}
  })
};

fetch('https://pay.autorizou.dev/api/v1/recipients', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://pay.autorizou.dev/api/v1/recipients",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'external_reference' => '<string>',
    'email' => '<string>',
    'legal_name' => '<string>',
    'trade_name' => '<string>',
    'status' => '<string>',
    'type' => '<string>',
    'company_type' => '<string>',
    'name' => '<string>',
    'birthday' => '<string>',
    'founding_date' => '<string>',
    'document' => [
        'document.type' => '<string>',
        'document.value' => '<string>'
    ],
    'phone' => [
        'phone.type' => '<string>',
        'phone.ddi' => '<string>',
        'phone.ddd' => '<string>',
        'phone.number' => '<string>'
    ],
    'address' => [
        'address.type' => '<string>',
        'address.line_1' => '<string>',
        'address.number' => '<string>',
        'address.line_2' => '<string>',
        'address.neighborhood' => '<string>',
        'address.city' => '<string>',
        'address.state' => '<string>',
        'address.postal_code' => '<string>',
        'address.country' => '<string>'
    ],
    'managing_partners' => [
        [
                'managing_partners[].name' => '<string>',
                'managing_partners[].email' => '<string>',
                'managing_partners[].document' => '<string>',
                'managing_partners[].birthday' => '<string>',
                'managing_partners[].nationality' => '<string>',
                'managing_partners[].type' => '<string>',
                'managing_partners[].role_description' => '<string>',
                'managing_partners[].phone' => [
                                'managing_partners[].phone.type' => '<string>',
                                'managing_partners[].phone.ddd' => '<string>',
                                'managing_partners[].phone.number' => '<string>'
                ]
        ]
    ],
    'bank_account' => [
        'bank_account.bank_ispb' => '<string>',
        'bank_account.holder_name' => '<string>',
        'bank_account.branch_number' => '<string>',
        'bank_account.branch_check_digit' => '<string>',
        'bank_account.account_number' => '<string>',
        'bank_account.account_check_digit' => '<string>',
        'bank_account.pix_key' => '<string>',
        'bank_account.pix_key_type' => '<string>',
        'bank_account.status' => '<string>',
        'bank_account.receiver_type' => '<string>'
    ],
    'metadata' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://pay.autorizou.dev/api/v1/recipients"

	payload := strings.NewReader("{\n  \"external_reference\": \"<string>\",\n  \"email\": \"<string>\",\n  \"legal_name\": \"<string>\",\n  \"trade_name\": \"<string>\",\n  \"status\": \"<string>\",\n  \"type\": \"<string>\",\n  \"company_type\": \"<string>\",\n  \"name\": \"<string>\",\n  \"birthday\": \"<string>\",\n  \"founding_date\": \"<string>\",\n  \"document\": {\n    \"document.type\": \"<string>\",\n    \"document.value\": \"<string>\"\n  },\n  \"phone\": {\n    \"phone.type\": \"<string>\",\n    \"phone.ddi\": \"<string>\",\n    \"phone.ddd\": \"<string>\",\n    \"phone.number\": \"<string>\"\n  },\n  \"address\": {\n    \"address.type\": \"<string>\",\n    \"address.line_1\": \"<string>\",\n    \"address.number\": \"<string>\",\n    \"address.line_2\": \"<string>\",\n    \"address.neighborhood\": \"<string>\",\n    \"address.city\": \"<string>\",\n    \"address.state\": \"<string>\",\n    \"address.postal_code\": \"<string>\",\n    \"address.country\": \"<string>\"\n  },\n  \"managing_partners\": [\n    {\n      \"managing_partners[].name\": \"<string>\",\n      \"managing_partners[].email\": \"<string>\",\n      \"managing_partners[].document\": \"<string>\",\n      \"managing_partners[].birthday\": \"<string>\",\n      \"managing_partners[].nationality\": \"<string>\",\n      \"managing_partners[].type\": \"<string>\",\n      \"managing_partners[].role_description\": \"<string>\",\n      \"managing_partners[].phone\": {\n        \"managing_partners[].phone.type\": \"<string>\",\n        \"managing_partners[].phone.ddd\": \"<string>\",\n        \"managing_partners[].phone.number\": \"<string>\"\n      }\n    }\n  ],\n  \"bank_account\": {\n    \"bank_account.bank_ispb\": \"<string>\",\n    \"bank_account.holder_name\": \"<string>\",\n    \"bank_account.branch_number\": \"<string>\",\n    \"bank_account.branch_check_digit\": \"<string>\",\n    \"bank_account.account_number\": \"<string>\",\n    \"bank_account.account_check_digit\": \"<string>\",\n    \"bank_account.pix_key\": \"<string>\",\n    \"bank_account.pix_key_type\": \"<string>\",\n    \"bank_account.status\": \"<string>\",\n    \"bank_account.receiver_type\": \"<string>\"\n  },\n  \"metadata\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://pay.autorizou.dev/api/v1/recipients")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"external_reference\": \"<string>\",\n  \"email\": \"<string>\",\n  \"legal_name\": \"<string>\",\n  \"trade_name\": \"<string>\",\n  \"status\": \"<string>\",\n  \"type\": \"<string>\",\n  \"company_type\": \"<string>\",\n  \"name\": \"<string>\",\n  \"birthday\": \"<string>\",\n  \"founding_date\": \"<string>\",\n  \"document\": {\n    \"document.type\": \"<string>\",\n    \"document.value\": \"<string>\"\n  },\n  \"phone\": {\n    \"phone.type\": \"<string>\",\n    \"phone.ddi\": \"<string>\",\n    \"phone.ddd\": \"<string>\",\n    \"phone.number\": \"<string>\"\n  },\n  \"address\": {\n    \"address.type\": \"<string>\",\n    \"address.line_1\": \"<string>\",\n    \"address.number\": \"<string>\",\n    \"address.line_2\": \"<string>\",\n    \"address.neighborhood\": \"<string>\",\n    \"address.city\": \"<string>\",\n    \"address.state\": \"<string>\",\n    \"address.postal_code\": \"<string>\",\n    \"address.country\": \"<string>\"\n  },\n  \"managing_partners\": [\n    {\n      \"managing_partners[].name\": \"<string>\",\n      \"managing_partners[].email\": \"<string>\",\n      \"managing_partners[].document\": \"<string>\",\n      \"managing_partners[].birthday\": \"<string>\",\n      \"managing_partners[].nationality\": \"<string>\",\n      \"managing_partners[].type\": \"<string>\",\n      \"managing_partners[].role_description\": \"<string>\",\n      \"managing_partners[].phone\": {\n        \"managing_partners[].phone.type\": \"<string>\",\n        \"managing_partners[].phone.ddd\": \"<string>\",\n        \"managing_partners[].phone.number\": \"<string>\"\n      }\n    }\n  ],\n  \"bank_account\": {\n    \"bank_account.bank_ispb\": \"<string>\",\n    \"bank_account.holder_name\": \"<string>\",\n    \"bank_account.branch_number\": \"<string>\",\n    \"bank_account.branch_check_digit\": \"<string>\",\n    \"bank_account.account_number\": \"<string>\",\n    \"bank_account.account_check_digit\": \"<string>\",\n    \"bank_account.pix_key\": \"<string>\",\n    \"bank_account.pix_key_type\": \"<string>\",\n    \"bank_account.status\": \"<string>\",\n    \"bank_account.receiver_type\": \"<string>\"\n  },\n  \"metadata\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://pay.autorizou.dev/api/v1/recipients")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"external_reference\": \"<string>\",\n  \"email\": \"<string>\",\n  \"legal_name\": \"<string>\",\n  \"trade_name\": \"<string>\",\n  \"status\": \"<string>\",\n  \"type\": \"<string>\",\n  \"company_type\": \"<string>\",\n  \"name\": \"<string>\",\n  \"birthday\": \"<string>\",\n  \"founding_date\": \"<string>\",\n  \"document\": {\n    \"document.type\": \"<string>\",\n    \"document.value\": \"<string>\"\n  },\n  \"phone\": {\n    \"phone.type\": \"<string>\",\n    \"phone.ddi\": \"<string>\",\n    \"phone.ddd\": \"<string>\",\n    \"phone.number\": \"<string>\"\n  },\n  \"address\": {\n    \"address.type\": \"<string>\",\n    \"address.line_1\": \"<string>\",\n    \"address.number\": \"<string>\",\n    \"address.line_2\": \"<string>\",\n    \"address.neighborhood\": \"<string>\",\n    \"address.city\": \"<string>\",\n    \"address.state\": \"<string>\",\n    \"address.postal_code\": \"<string>\",\n    \"address.country\": \"<string>\"\n  },\n  \"managing_partners\": [\n    {\n      \"managing_partners[].name\": \"<string>\",\n      \"managing_partners[].email\": \"<string>\",\n      \"managing_partners[].document\": \"<string>\",\n      \"managing_partners[].birthday\": \"<string>\",\n      \"managing_partners[].nationality\": \"<string>\",\n      \"managing_partners[].type\": \"<string>\",\n      \"managing_partners[].role_description\": \"<string>\",\n      \"managing_partners[].phone\": {\n        \"managing_partners[].phone.type\": \"<string>\",\n        \"managing_partners[].phone.ddd\": \"<string>\",\n        \"managing_partners[].phone.number\": \"<string>\"\n      }\n    }\n  ],\n  \"bank_account\": {\n    \"bank_account.bank_ispb\": \"<string>\",\n    \"bank_account.holder_name\": \"<string>\",\n    \"bank_account.branch_number\": \"<string>\",\n    \"bank_account.branch_check_digit\": \"<string>\",\n    \"bank_account.account_number\": \"<string>\",\n    \"bank_account.account_check_digit\": \"<string>\",\n    \"bank_account.pix_key\": \"<string>\",\n    \"bank_account.pix_key_type\": \"<string>\",\n    \"bank_account.status\": \"<string>\",\n    \"bank_account.receiver_type\": \"<string>\"\n  },\n  \"metadata\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "message": "Os dados fornecidos são inválidos",
  "errors": {
    "document.value": ["CPF inválido"],
    "email": ["O campo email é obrigatório"],
    "managing_partners": ["É necessário pelo menos um sócio administrador"]
  }
}

{
  "message": "País não encontrado",
  "errors": {
    "address.country": ["O país informado não existe"]
  }
}

POST

api

recipients

Criar Recebedor

curl --request POST \
  --url https://pay.autorizou.dev/api/v1/recipients \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "external_reference": "<string>",
  "email": "<string>",
  "legal_name": "<string>",
  "trade_name": "<string>",
  "status": "<string>",
  "type": "<string>",
  "company_type": "<string>",
  "name": "<string>",
  "birthday": "<string>",
  "founding_date": "<string>",
  "document": {
    "document.type": "<string>",
    "document.value": "<string>"
  },
  "phone": {
    "phone.type": "<string>",
    "phone.ddi": "<string>",
    "phone.ddd": "<string>",
    "phone.number": "<string>"
  },
  "address": {
    "address.type": "<string>",
    "address.line_1": "<string>",
    "address.number": "<string>",
    "address.line_2": "<string>",
    "address.neighborhood": "<string>",
    "address.city": "<string>",
    "address.state": "<string>",
    "address.postal_code": "<string>",
    "address.country": "<string>"
  },
  "managing_partners": [
    {
      "managing_partners[].name": "<string>",
      "managing_partners[].email": "<string>",
      "managing_partners[].document": "<string>",
      "managing_partners[].birthday": "<string>",
      "managing_partners[].nationality": "<string>",
      "managing_partners[].type": "<string>",
      "managing_partners[].role_description": "<string>",
      "managing_partners[].phone": {
        "managing_partners[].phone.type": "<string>",
        "managing_partners[].phone.ddd": "<string>",
        "managing_partners[].phone.number": "<string>"
      }
    }
  ],
  "bank_account": {
    "bank_account.bank_ispb": "<string>",
    "bank_account.holder_name": "<string>",
    "bank_account.branch_number": "<string>",
    "bank_account.branch_check_digit": "<string>",
    "bank_account.account_number": "<string>",
    "bank_account.account_check_digit": "<string>",
    "bank_account.pix_key": "<string>",
    "bank_account.pix_key_type": "<string>",
    "bank_account.status": "<string>",
    "bank_account.receiver_type": "<string>"
  },
  "metadata": {}
}
'

import requests

url = "https://pay.autorizou.dev/api/v1/recipients"

payload = {
    "external_reference": "<string>",
    "email": "<string>",
    "legal_name": "<string>",
    "trade_name": "<string>",
    "status": "<string>",
    "type": "<string>",
    "company_type": "<string>",
    "name": "<string>",
    "birthday": "<string>",
    "founding_date": "<string>",
    "document": {
        "document.type": "<string>",
        "document.value": "<string>"
    },
    "phone": {
        "phone.type": "<string>",
        "phone.ddi": "<string>",
        "phone.ddd": "<string>",
        "phone.number": "<string>"
    },
    "address": {
        "address.type": "<string>",
        "address.line_1": "<string>",
        "address.number": "<string>",
        "address.line_2": "<string>",
        "address.neighborhood": "<string>",
        "address.city": "<string>",
        "address.state": "<string>",
        "address.postal_code": "<string>",
        "address.country": "<string>"
    },
    "managing_partners": [
        {
            "managing_partners[].name": "<string>",
            "managing_partners[].email": "<string>",
            "managing_partners[].document": "<string>",
            "managing_partners[].birthday": "<string>",
            "managing_partners[].nationality": "<string>",
            "managing_partners[].type": "<string>",
            "managing_partners[].role_description": "<string>",
            "managing_partners[].phone": {
                "managing_partners[].phone.type": "<string>",
                "managing_partners[].phone.ddd": "<string>",
                "managing_partners[].phone.number": "<string>"
            }
        }
    ],
    "bank_account": {
        "bank_account.bank_ispb": "<string>",
        "bank_account.holder_name": "<string>",
        "bank_account.branch_number": "<string>",
        "bank_account.branch_check_digit": "<string>",
        "bank_account.account_number": "<string>",
        "bank_account.account_check_digit": "<string>",
        "bank_account.pix_key": "<string>",
        "bank_account.pix_key_type": "<string>",
        "bank_account.status": "<string>",
        "bank_account.receiver_type": "<string>"
    },
    "metadata": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    external_reference: '<string>',
    email: '<string>',
    legal_name: '<string>',
    trade_name: '<string>',
    status: '<string>',
    type: '<string>',
    company_type: '<string>',
    name: '<string>',
    birthday: '<string>',
    founding_date: '<string>',
    document: {'document.type': '<string>', 'document.value': '<string>'},
    phone: {
      'phone.type': '<string>',
      'phone.ddi': '<string>',
      'phone.ddd': '<string>',
      'phone.number': '<string>'
    },
    address: {
      'address.type': '<string>',
      'address.line_1': '<string>',
      'address.number': '<string>',
      'address.line_2': '<string>',
      'address.neighborhood': '<string>',
      'address.city': '<string>',
      'address.state': '<string>',
      'address.postal_code': '<string>',
      'address.country': '<string>'
    },
    managing_partners: [
      {
        'managing_partners[].name': '<string>',
        'managing_partners[].email': '<string>',
        'managing_partners[].document': '<string>',
        'managing_partners[].birthday': '<string>',
        'managing_partners[].nationality': '<string>',
        'managing_partners[].type': '<string>',
        'managing_partners[].role_description': '<string>',
        'managing_partners[].phone': {
          'managing_partners[].phone.type': '<string>',
          'managing_partners[].phone.ddd': '<string>',
          'managing_partners[].phone.number': '<string>'
        }
      }
    ],
    bank_account: {
      'bank_account.bank_ispb': '<string>',
      'bank_account.holder_name': '<string>',
      'bank_account.branch_number': '<string>',
      'bank_account.branch_check_digit': '<string>',
      'bank_account.account_number': '<string>',
      'bank_account.account_check_digit': '<string>',
      'bank_account.pix_key': '<string>',
      'bank_account.pix_key_type': '<string>',
      'bank_account.status': '<string>',
      'bank_account.receiver_type': '<string>'
    },
    metadata: {}
  })
};

fetch('https://pay.autorizou.dev/api/v1/recipients', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://pay.autorizou.dev/api/v1/recipients",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'external_reference' => '<string>',
    'email' => '<string>',
    'legal_name' => '<string>',
    'trade_name' => '<string>',
    'status' => '<string>',
    'type' => '<string>',
    'company_type' => '<string>',
    'name' => '<string>',
    'birthday' => '<string>',
    'founding_date' => '<string>',
    'document' => [
        'document.type' => '<string>',
        'document.value' => '<string>'
    ],
    'phone' => [
        'phone.type' => '<string>',
        'phone.ddi' => '<string>',
        'phone.ddd' => '<string>',
        'phone.number' => '<string>'
    ],
    'address' => [
        'address.type' => '<string>',
        'address.line_1' => '<string>',
        'address.number' => '<string>',
        'address.line_2' => '<string>',
        'address.neighborhood' => '<string>',
        'address.city' => '<string>',
        'address.state' => '<string>',
        'address.postal_code' => '<string>',
        'address.country' => '<string>'
    ],
    'managing_partners' => [
        [
                'managing_partners[].name' => '<string>',
                'managing_partners[].email' => '<string>',
                'managing_partners[].document' => '<string>',
                'managing_partners[].birthday' => '<string>',
                'managing_partners[].nationality' => '<string>',
                'managing_partners[].type' => '<string>',
                'managing_partners[].role_description' => '<string>',
                'managing_partners[].phone' => [
                                'managing_partners[].phone.type' => '<string>',
                                'managing_partners[].phone.ddd' => '<string>',
                                'managing_partners[].phone.number' => '<string>'
                ]
        ]
    ],
    'bank_account' => [
        'bank_account.bank_ispb' => '<string>',
        'bank_account.holder_name' => '<string>',
        'bank_account.branch_number' => '<string>',
        'bank_account.branch_check_digit' => '<string>',
        'bank_account.account_number' => '<string>',
        'bank_account.account_check_digit' => '<string>',
        'bank_account.pix_key' => '<string>',
        'bank_account.pix_key_type' => '<string>',
        'bank_account.status' => '<string>',
        'bank_account.receiver_type' => '<string>'
    ],
    'metadata' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://pay.autorizou.dev/api/v1/recipients"

	payload := strings.NewReader("{\n  \"external_reference\": \"<string>\",\n  \"email\": \"<string>\",\n  \"legal_name\": \"<string>\",\n  \"trade_name\": \"<string>\",\n  \"status\": \"<string>\",\n  \"type\": \"<string>\",\n  \"company_type\": \"<string>\",\n  \"name\": \"<string>\",\n  \"birthday\": \"<string>\",\n  \"founding_date\": \"<string>\",\n  \"document\": {\n    \"document.type\": \"<string>\",\n    \"document.value\": \"<string>\"\n  },\n  \"phone\": {\n    \"phone.type\": \"<string>\",\n    \"phone.ddi\": \"<string>\",\n    \"phone.ddd\": \"<string>\",\n    \"phone.number\": \"<string>\"\n  },\n  \"address\": {\n    \"address.type\": \"<string>\",\n    \"address.line_1\": \"<string>\",\n    \"address.number\": \"<string>\",\n    \"address.line_2\": \"<string>\",\n    \"address.neighborhood\": \"<string>\",\n    \"address.city\": \"<string>\",\n    \"address.state\": \"<string>\",\n    \"address.postal_code\": \"<string>\",\n    \"address.country\": \"<string>\"\n  },\n  \"managing_partners\": [\n    {\n      \"managing_partners[].name\": \"<string>\",\n      \"managing_partners[].email\": \"<string>\",\n      \"managing_partners[].document\": \"<string>\",\n      \"managing_partners[].birthday\": \"<string>\",\n      \"managing_partners[].nationality\": \"<string>\",\n      \"managing_partners[].type\": \"<string>\",\n      \"managing_partners[].role_description\": \"<string>\",\n      \"managing_partners[].phone\": {\n        \"managing_partners[].phone.type\": \"<string>\",\n        \"managing_partners[].phone.ddd\": \"<string>\",\n        \"managing_partners[].phone.number\": \"<string>\"\n      }\n    }\n  ],\n  \"bank_account\": {\n    \"bank_account.bank_ispb\": \"<string>\",\n    \"bank_account.holder_name\": \"<string>\",\n    \"bank_account.branch_number\": \"<string>\",\n    \"bank_account.branch_check_digit\": \"<string>\",\n    \"bank_account.account_number\": \"<string>\",\n    \"bank_account.account_check_digit\": \"<string>\",\n    \"bank_account.pix_key\": \"<string>\",\n    \"bank_account.pix_key_type\": \"<string>\",\n    \"bank_account.status\": \"<string>\",\n    \"bank_account.receiver_type\": \"<string>\"\n  },\n  \"metadata\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://pay.autorizou.dev/api/v1/recipients")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"external_reference\": \"<string>\",\n  \"email\": \"<string>\",\n  \"legal_name\": \"<string>\",\n  \"trade_name\": \"<string>\",\n  \"status\": \"<string>\",\n  \"type\": \"<string>\",\n  \"company_type\": \"<string>\",\n  \"name\": \"<string>\",\n  \"birthday\": \"<string>\",\n  \"founding_date\": \"<string>\",\n  \"document\": {\n    \"document.type\": \"<string>\",\n    \"document.value\": \"<string>\"\n  },\n  \"phone\": {\n    \"phone.type\": \"<string>\",\n    \"phone.ddi\": \"<string>\",\n    \"phone.ddd\": \"<string>\",\n    \"phone.number\": \"<string>\"\n  },\n  \"address\": {\n    \"address.type\": \"<string>\",\n    \"address.line_1\": \"<string>\",\n    \"address.number\": \"<string>\",\n    \"address.line_2\": \"<string>\",\n    \"address.neighborhood\": \"<string>\",\n    \"address.city\": \"<string>\",\n    \"address.state\": \"<string>\",\n    \"address.postal_code\": \"<string>\",\n    \"address.country\": \"<string>\"\n  },\n  \"managing_partners\": [\n    {\n      \"managing_partners[].name\": \"<string>\",\n      \"managing_partners[].email\": \"<string>\",\n      \"managing_partners[].document\": \"<string>\",\n      \"managing_partners[].birthday\": \"<string>\",\n      \"managing_partners[].nationality\": \"<string>\",\n      \"managing_partners[].type\": \"<string>\",\n      \"managing_partners[].role_description\": \"<string>\",\n      \"managing_partners[].phone\": {\n        \"managing_partners[].phone.type\": \"<string>\",\n        \"managing_partners[].phone.ddd\": \"<string>\",\n        \"managing_partners[].phone.number\": \"<string>\"\n      }\n    }\n  ],\n  \"bank_account\": {\n    \"bank_account.bank_ispb\": \"<string>\",\n    \"bank_account.holder_name\": \"<string>\",\n    \"bank_account.branch_number\": \"<string>\",\n    \"bank_account.branch_check_digit\": \"<string>\",\n    \"bank_account.account_number\": \"<string>\",\n    \"bank_account.account_check_digit\": \"<string>\",\n    \"bank_account.pix_key\": \"<string>\",\n    \"bank_account.pix_key_type\": \"<string>\",\n    \"bank_account.status\": \"<string>\",\n    \"bank_account.receiver_type\": \"<string>\"\n  },\n  \"metadata\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://pay.autorizou.dev/api/v1/recipients")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"external_reference\": \"<string>\",\n  \"email\": \"<string>\",\n  \"legal_name\": \"<string>\",\n  \"trade_name\": \"<string>\",\n  \"status\": \"<string>\",\n  \"type\": \"<string>\",\n  \"company_type\": \"<string>\",\n  \"name\": \"<string>\",\n  \"birthday\": \"<string>\",\n  \"founding_date\": \"<string>\",\n  \"document\": {\n    \"document.type\": \"<string>\",\n    \"document.value\": \"<string>\"\n  },\n  \"phone\": {\n    \"phone.type\": \"<string>\",\n    \"phone.ddi\": \"<string>\",\n    \"phone.ddd\": \"<string>\",\n    \"phone.number\": \"<string>\"\n  },\n  \"address\": {\n    \"address.type\": \"<string>\",\n    \"address.line_1\": \"<string>\",\n    \"address.number\": \"<string>\",\n    \"address.line_2\": \"<string>\",\n    \"address.neighborhood\": \"<string>\",\n    \"address.city\": \"<string>\",\n    \"address.state\": \"<string>\",\n    \"address.postal_code\": \"<string>\",\n    \"address.country\": \"<string>\"\n  },\n  \"managing_partners\": [\n    {\n      \"managing_partners[].name\": \"<string>\",\n      \"managing_partners[].email\": \"<string>\",\n      \"managing_partners[].document\": \"<string>\",\n      \"managing_partners[].birthday\": \"<string>\",\n      \"managing_partners[].nationality\": \"<string>\",\n      \"managing_partners[].type\": \"<string>\",\n      \"managing_partners[].role_description\": \"<string>\",\n      \"managing_partners[].phone\": {\n        \"managing_partners[].phone.type\": \"<string>\",\n        \"managing_partners[].phone.ddd\": \"<string>\",\n        \"managing_partners[].phone.number\": \"<string>\"\n      }\n    }\n  ],\n  \"bank_account\": {\n    \"bank_account.bank_ispb\": \"<string>\",\n    \"bank_account.holder_name\": \"<string>\",\n    \"bank_account.branch_number\": \"<string>\",\n    \"bank_account.branch_check_digit\": \"<string>\",\n    \"bank_account.account_number\": \"<string>\",\n    \"bank_account.account_check_digit\": \"<string>\",\n    \"bank_account.pix_key\": \"<string>\",\n    \"bank_account.pix_key_type\": \"<string>\",\n    \"bank_account.status\": \"<string>\",\n    \"bank_account.receiver_type\": \"<string>\"\n  },\n  \"metadata\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "message": "Os dados fornecidos são inválidos",
  "errors": {
    "document.value": ["CPF inválido"],
    "email": ["O campo email é obrigatório"],
    "managing_partners": ["É necessário pelo menos um sócio administrador"]
  }
}

{
  "message": "País não encontrado",
  "errors": {
    "address.country": ["O país informado não existe"]
  }
}

Permite cadastrar destinatários (pessoas físicas ou jurídicas) que irão receber valores em splits de pagamento. Essencial para marketplaces e plataformas que precisam dividir pagamentos entre múltiplas partes.

Comportamento Especial: Se já existir um destinatário com o mesmo email para o seu merchant, a API retorna o destinatário existente com status 200 ao invés de criar um novo.

Parâmetros da Requisição

string

required

Identificador único do destinatário no seu sistema

string

required

Email válido para contato

string

required

Nome legal ou razão social

string

required

Nome fantasia ou comercial

string

required

Status do destinatárioValores: approved, pending, blocked, reproved

string

required

Tipo de pessoaValores: individual (pessoa física), company (pessoa jurídica)

string

required

Tipo de empresaValores: MEI, ME, EPP, LTDA, EIRELI, SA, AUT, OTHER

string

Nome completo (obrigatório quando type = "individual")

date

Data de nascimento no formato YYYY-MM-DD (obrigatório quando type = "individual")

date

Data de fundação no formato YYYY-MM-DD (obrigatório quando type = "company")

Documento

object

required

Show Dados do documento

string

required

Tipo do documentoValores: cpf, cnpj

string

required

Número do documento (apenas dígitos, sem formatação)

Telefone

object

required

Show Dados do telefone

string

required

Tipo do telefoneValores: residential, mobile, commercial, public

string

required

Código DDI do país (ex: "55" para Brasil)

string

required

Código de área DDD (ex: "11")

string

required

Número do telefone (apenas dígitos)

Endereço

object

required

Show Dados do endereço

string

required

Tipo de endereçoValores: billing (cobrança), shipping (entrega)

string

required

Logradouro (rua/avenida)

string

required

Número do endereço

string

Complemento (opcional)

string

required

Bairro

string

required

Cidade

string

required

Estado (sigla de 2 caracteres, ex: "SP")

string

required

CEP (apenas números, 8 dígitos)

string

required

País (código ISO alpha-2, ex: "BR")

Sócios Administradores

array

required

Lista de sócios administradores (mínimo 1)

Show Dados de cada sócio

string

required

Nome completo do sócio

string

required

Email do sócio

string

required

CPF do sócio (11 dígitos)

date

required

Data de nascimento (YYYY-MM-DD)

string

required

Nacionalidade

string

required

Tipo de sócio (2 caracteres, ex: "AD")

string

required

Descrição do cargo/função

object

required

Show Telefone do sócio

string

required

Tipo do telefone

string

required

DDD (2 dígitos)

string

required

Número do telefone (até 9 dígitos)

Dados Bancários (Opcional)

object

Dados bancários para recebimento (se fornecido, todos os sub-campos são obrigatórios)

Show Dados da conta bancária

string

required

Código ISPB do banco (8 dígitos)

string

required

Nome do titular da conta

string

required

Número da agência (sem dígito)

string

Dígito verificador da agência (quando aplicável)

string

required

Número da conta (sem dígito)

string

required

Dígito verificador da conta

string

Chave PIX (opcional)

string

Tipo da chave PIX (obrigatório se pix_key fornecido)Valores: cpf, cnpj, phone, email, random

string

required

Status da conta bancáriaValores: approved, pending, reproved

string

required

Tipo de contaValores: checking (corrente), saving (poupança)

Metadados

object

Dados adicionais personalizados (formato chave-valor)

Exemplos de Requisição

curl -X POST https://pay.autorizou.dev/api/v1/recipients \
  -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc" \
  -H "Content-Type: application/json" \
  -d '{
    "external_reference": "seller_001",
    "email": "maria.vendedora@exemplo.com.br",
    "legal_name": "Maria da Silva Vendedora",
    "trade_name": "Maria Vendedora",
    "status": "approved",
    "type": "individual",
    "company_type": "MEI",
    "name": "Maria da Silva Vendedora",
    "birthday": "1990-05-15",
    "document": {
      "type": "cpf",
      "value": "12345678901"
    },
    "phone": {
      "type": "mobile",
      "ddi": "55",
      "ddd": "11",
      "number": "987654321"
    },
    "address": {
      "type": "billing",
      "line_1": "Rua das Flores",
      "number": "123",
      "line_2": "Apto 45",
      "neighborhood": "Vila Madalena",
      "city": "São Paulo",
      "state": "SP",
      "postal_code": "01234567",
      "country": "BR"
    },
    "managing_partners": [
      {
        "name": "Maria da Silva Vendedora",
        "email": "maria@exemplo.com.br",
        "document": "12345678901",
        "birthday": "1990-05-15",
        "nationality": "brasileira",
        "type": "AD",
        "role_description": "Proprietária",
        "phone": {
          "type": "mobile",
          "ddd": "11",
          "number": "987654321"
        }
      }
    ],
    "bank_account": {
      "bank_ispb": "00000000",
      "holder_name": "Maria da Silva Vendedora",
      "branch_number": "1234",
      "account_number": "567890",
      "account_check_digit": "1",
      "status": "approved",
      "receiver_type": "checking"
    }
  }'

curl -X POST https://pay.autorizou.dev/api/v1/recipients \
  -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc" \
  -H "Content-Type: application/json" \
  -d '{
    "external_reference": "company_tech_store",
    "email": "financeiro@techstore.com.br",
    "legal_name": "Tech Store Comércio de Eletrônicos LTDA",
    "trade_name": "Tech Store",
    "status": "approved",
    "type": "company",
    "company_type": "LTDA",
    "founding_date": "2020-01-15",
    "document": {
      "type": "cnpj",
      "value": "12345678000195"
    },
    "phone": {
      "type": "commercial",
      "ddi": "55",
      "ddd": "11",
      "number": "33334444"
    },
    "address": {
      "type": "billing",
      "line_1": "Av. Paulista",
      "number": "1000",
      "line_2": "Sala 1001",
      "neighborhood": "Bela Vista",
      "city": "São Paulo",
      "state": "SP",
      "postal_code": "01310100",
      "country": "BR"
    },
    "managing_partners": [
      {
        "name": "João Silva Santos",
        "email": "joao@techstore.com.br",
        "document": "98765432100",
        "birthday": "1985-03-20",
        "nationality": "brasileira",
        "type": "AD",
        "role_description": "Diretor Administrativo",
        "phone": {
          "type": "mobile",
          "ddd": "11",
          "number": "988887777"
        }
      }
    ],
    "bank_account": {
      "bank_ispb": "60701190",
      "holder_name": "Tech Store Comércio de Eletrônicos LTDA",
      "branch_number": "5678",
      "account_number": "123456",
      "account_check_digit": "9",
      "status": "approved",
      "receiver_type": "checking",
      "pix_key": "financeiro@techstore.com.br",
      "pix_key_type": "email"
    }
  }'

Resposta

string

UUID único do destinatário

string

Hash único do destinatário

string

Email do destinatário

string

Data/hora de criação (formato: DD/MM/YYYY HH:mm:ss)

string

Data/hora da última atualização

Exemplos de Resposta

201 Created - Novo destinatário

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "hash": "RCP_abc123xyz789",
  "email": "maria.vendedora@exemplo.com.br",
  "created_at": "15/01/2024 10:30:00",
  "updated_at": "15/01/2024 10:30:00"
}

200 OK - Recebedor já existe

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "hash": "RCP_abc123xyz789",
  "email": "maria.vendedora@exemplo.com.br",
  "created_at": "10/01/2024 14:20:00",
  "updated_at": "10/01/2024 14:20:00"
}

Códigos de Status

{
  "message": "Os dados fornecidos são inválidos",
  "errors": {
    "document.value": ["CPF inválido"],
    "email": ["O campo email é obrigatório"],
    "managing_partners": ["É necessário pelo menos um sócio administrador"]
  }
}

{
  "message": "País não encontrado",
  "errors": {
    "address.country": ["O país informado não existe"]
  }
}

Próximos Passos

Após criar um destinatário:

Buscar destinatário para validar criação
Atualizar dados se necessário
Usar em split de pagamento para dividir valores

Conta

Clientes

Cartões

Pedidos

Produtos e Ofertas

Assinaturas

Pagamentos

Links de Pagamento

POS / Maquininhas

Apple Pay

Reembolsos

Recebedores

Motivos de Recusa

Webhooks

Modelos de Dados

Criar Recebedor

Parâmetros da Requisição

Documento

Telefone

Endereço

Sócios Administradores

Dados Bancários (Opcional)

Metadados

Exemplos de Requisição

Resposta

Exemplos de Resposta

Códigos de Status

Próximos Passos

​Parâmetros da Requisição

​Documento

​Telefone

​Endereço

​Sócios Administradores

​Dados Bancários (Opcional)

​Metadados

​Exemplos de Requisição

​Resposta

​Exemplos de Resposta

​Códigos de Status

​Próximos Passos

Parâmetros da Requisição

Documento

Telefone

Endereço

Sócios Administradores

Dados Bancários (Opcional)

Metadados

Exemplos de Requisição

Resposta

Exemplos de Resposta

Códigos de Status

Próximos Passos