curl --request POST \
--url https://spi.sandbox.lerian.net/api/v1/brcode/cob \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"calendario": {
"expiracao": 3600
},
"chave": "pix@lerian.studio",
"valor": {
"original": "250.00",
"modalidadeAlteracao": 0,
"retirada": {}
},
"devedor": {
"cep": "<string>",
"cidade": "<string>",
"cnpj": "12ABC34501DE35",
"cpf": "12345678901",
"email": "<string>",
"logradouro": "<string>",
"nome": "Fulano de Tal",
"uf": "<string>"
},
"infoAdicionais": [
{
"nome": "<string>",
"valor": "<string>"
}
],
"loc": {
"id": 123
},
"solicitacaoPagador": "<string>"
}
'import requests
url = "https://spi.sandbox.lerian.net/api/v1/brcode/cob"
payload = {
"calendario": { "expiracao": 3600 },
"chave": "pix@lerian.studio",
"valor": {
"original": "250.00",
"modalidadeAlteracao": 0,
"retirada": {}
},
"devedor": {
"cep": "<string>",
"cidade": "<string>",
"cnpj": "12ABC34501DE35",
"cpf": "12345678901",
"email": "<string>",
"logradouro": "<string>",
"nome": "Fulano de Tal",
"uf": "<string>"
},
"infoAdicionais": [
{
"nome": "<string>",
"valor": "<string>"
}
],
"loc": { "id": 123 },
"solicitacaoPagador": "<string>"
}
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({
calendario: {expiracao: 3600},
chave: 'pix@lerian.studio',
valor: {original: '250.00', modalidadeAlteracao: 0, retirada: {}},
devedor: {
cep: '<string>',
cidade: '<string>',
cnpj: '12ABC34501DE35',
cpf: '12345678901',
email: '<string>',
logradouro: '<string>',
nome: 'Fulano de Tal',
uf: '<string>'
},
infoAdicionais: [{nome: '<string>', valor: '<string>'}],
loc: {id: 123},
solicitacaoPagador: '<string>'
})
};
fetch('https://spi.sandbox.lerian.net/api/v1/brcode/cob', 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://spi.sandbox.lerian.net/api/v1/brcode/cob",
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([
'calendario' => [
'expiracao' => 3600
],
'chave' => 'pix@lerian.studio',
'valor' => [
'original' => '250.00',
'modalidadeAlteracao' => 0,
'retirada' => [
]
],
'devedor' => [
'cep' => '<string>',
'cidade' => '<string>',
'cnpj' => '12ABC34501DE35',
'cpf' => '12345678901',
'email' => '<string>',
'logradouro' => '<string>',
'nome' => 'Fulano de Tal',
'uf' => '<string>'
],
'infoAdicionais' => [
[
'nome' => '<string>',
'valor' => '<string>'
]
],
'loc' => [
'id' => 123
],
'solicitacaoPagador' => '<string>'
]),
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://spi.sandbox.lerian.net/api/v1/brcode/cob"
payload := strings.NewReader("{\n \"calendario\": {\n \"expiracao\": 3600\n },\n \"chave\": \"pix@lerian.studio\",\n \"valor\": {\n \"original\": \"250.00\",\n \"modalidadeAlteracao\": 0,\n \"retirada\": {}\n },\n \"devedor\": {\n \"cep\": \"<string>\",\n \"cidade\": \"<string>\",\n \"cnpj\": \"12ABC34501DE35\",\n \"cpf\": \"12345678901\",\n \"email\": \"<string>\",\n \"logradouro\": \"<string>\",\n \"nome\": \"Fulano de Tal\",\n \"uf\": \"<string>\"\n },\n \"infoAdicionais\": [\n {\n \"nome\": \"<string>\",\n \"valor\": \"<string>\"\n }\n ],\n \"loc\": {\n \"id\": 123\n },\n \"solicitacaoPagador\": \"<string>\"\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://spi.sandbox.lerian.net/api/v1/brcode/cob")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"calendario\": {\n \"expiracao\": 3600\n },\n \"chave\": \"pix@lerian.studio\",\n \"valor\": {\n \"original\": \"250.00\",\n \"modalidadeAlteracao\": 0,\n \"retirada\": {}\n },\n \"devedor\": {\n \"cep\": \"<string>\",\n \"cidade\": \"<string>\",\n \"cnpj\": \"12ABC34501DE35\",\n \"cpf\": \"12345678901\",\n \"email\": \"<string>\",\n \"logradouro\": \"<string>\",\n \"nome\": \"Fulano de Tal\",\n \"uf\": \"<string>\"\n },\n \"infoAdicionais\": [\n {\n \"nome\": \"<string>\",\n \"valor\": \"<string>\"\n }\n ],\n \"loc\": {\n \"id\": 123\n },\n \"solicitacaoPagador\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://spi.sandbox.lerian.net/api/v1/brcode/cob")
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 \"calendario\": {\n \"expiracao\": 3600\n },\n \"chave\": \"pix@lerian.studio\",\n \"valor\": {\n \"original\": \"250.00\",\n \"modalidadeAlteracao\": 0,\n \"retirada\": {}\n },\n \"devedor\": {\n \"cep\": \"<string>\",\n \"cidade\": \"<string>\",\n \"cnpj\": \"12ABC34501DE35\",\n \"cpf\": \"12345678901\",\n \"email\": \"<string>\",\n \"logradouro\": \"<string>\",\n \"nome\": \"Fulano de Tal\",\n \"uf\": \"<string>\"\n },\n \"infoAdicionais\": [\n {\n \"nome\": \"<string>\",\n \"valor\": \"<string>\"\n }\n ],\n \"loc\": {\n \"id\": 123\n },\n \"solicitacaoPagador\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"calendario": {
"criacao": "<string>",
"expiracao": 123
},
"chave": "<string>",
"loc": {
"criacao": "<string>",
"id": 123,
"tipoCob": "cob",
"location": "<string>"
},
"location": "<string>",
"pixCopiaECola": "<string>",
"revisao": 123,
"status": "ATIVA",
"txid": "<string>",
"valor": {
"modalidadeAlteracao": 0,
"original": "250.00",
"retirada": {
"saque": {
"modalidadeAgente": "AGPSS",
"prestadorDoServicoDeSaque": "12345678",
"valor": "5.00",
"modalidadeAlteracao": 0
},
"troco": {
"modalidadeAgente": "AGPSS",
"prestadorDoServicoDeSaque": "12345678",
"valor": "5.00",
"modalidadeAlteracao": 0
}
}
},
"devedor": {
"cep": "<string>",
"cidade": "<string>",
"cnpj": "12ABC34501DE35",
"cpf": "12345678901",
"email": "<string>",
"logradouro": "<string>",
"nome": "Fulano de Tal",
"uf": "<string>"
},
"infoAdicionais": [
{
"nome": "<string>",
"valor": "<string>"
}
],
"solicitacaoPagador": "<string>"
}{
"code": "ERR-0001",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Criar cobrança imediata (txid gerado pelo PSP)
Pré-requisito: crie esta cobrança antes de gerar seu QR/payload (consulte generateBRCode e resolveCobPayload). Cria uma cobrança imediata (Cob) com txid gerado pelo servidor. API Pix v2.9 POST /cob.
curl --request POST \
--url https://spi.sandbox.lerian.net/api/v1/brcode/cob \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"calendario": {
"expiracao": 3600
},
"chave": "pix@lerian.studio",
"valor": {
"original": "250.00",
"modalidadeAlteracao": 0,
"retirada": {}
},
"devedor": {
"cep": "<string>",
"cidade": "<string>",
"cnpj": "12ABC34501DE35",
"cpf": "12345678901",
"email": "<string>",
"logradouro": "<string>",
"nome": "Fulano de Tal",
"uf": "<string>"
},
"infoAdicionais": [
{
"nome": "<string>",
"valor": "<string>"
}
],
"loc": {
"id": 123
},
"solicitacaoPagador": "<string>"
}
'import requests
url = "https://spi.sandbox.lerian.net/api/v1/brcode/cob"
payload = {
"calendario": { "expiracao": 3600 },
"chave": "pix@lerian.studio",
"valor": {
"original": "250.00",
"modalidadeAlteracao": 0,
"retirada": {}
},
"devedor": {
"cep": "<string>",
"cidade": "<string>",
"cnpj": "12ABC34501DE35",
"cpf": "12345678901",
"email": "<string>",
"logradouro": "<string>",
"nome": "Fulano de Tal",
"uf": "<string>"
},
"infoAdicionais": [
{
"nome": "<string>",
"valor": "<string>"
}
],
"loc": { "id": 123 },
"solicitacaoPagador": "<string>"
}
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({
calendario: {expiracao: 3600},
chave: 'pix@lerian.studio',
valor: {original: '250.00', modalidadeAlteracao: 0, retirada: {}},
devedor: {
cep: '<string>',
cidade: '<string>',
cnpj: '12ABC34501DE35',
cpf: '12345678901',
email: '<string>',
logradouro: '<string>',
nome: 'Fulano de Tal',
uf: '<string>'
},
infoAdicionais: [{nome: '<string>', valor: '<string>'}],
loc: {id: 123},
solicitacaoPagador: '<string>'
})
};
fetch('https://spi.sandbox.lerian.net/api/v1/brcode/cob', 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://spi.sandbox.lerian.net/api/v1/brcode/cob",
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([
'calendario' => [
'expiracao' => 3600
],
'chave' => 'pix@lerian.studio',
'valor' => [
'original' => '250.00',
'modalidadeAlteracao' => 0,
'retirada' => [
]
],
'devedor' => [
'cep' => '<string>',
'cidade' => '<string>',
'cnpj' => '12ABC34501DE35',
'cpf' => '12345678901',
'email' => '<string>',
'logradouro' => '<string>',
'nome' => 'Fulano de Tal',
'uf' => '<string>'
],
'infoAdicionais' => [
[
'nome' => '<string>',
'valor' => '<string>'
]
],
'loc' => [
'id' => 123
],
'solicitacaoPagador' => '<string>'
]),
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://spi.sandbox.lerian.net/api/v1/brcode/cob"
payload := strings.NewReader("{\n \"calendario\": {\n \"expiracao\": 3600\n },\n \"chave\": \"pix@lerian.studio\",\n \"valor\": {\n \"original\": \"250.00\",\n \"modalidadeAlteracao\": 0,\n \"retirada\": {}\n },\n \"devedor\": {\n \"cep\": \"<string>\",\n \"cidade\": \"<string>\",\n \"cnpj\": \"12ABC34501DE35\",\n \"cpf\": \"12345678901\",\n \"email\": \"<string>\",\n \"logradouro\": \"<string>\",\n \"nome\": \"Fulano de Tal\",\n \"uf\": \"<string>\"\n },\n \"infoAdicionais\": [\n {\n \"nome\": \"<string>\",\n \"valor\": \"<string>\"\n }\n ],\n \"loc\": {\n \"id\": 123\n },\n \"solicitacaoPagador\": \"<string>\"\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://spi.sandbox.lerian.net/api/v1/brcode/cob")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"calendario\": {\n \"expiracao\": 3600\n },\n \"chave\": \"pix@lerian.studio\",\n \"valor\": {\n \"original\": \"250.00\",\n \"modalidadeAlteracao\": 0,\n \"retirada\": {}\n },\n \"devedor\": {\n \"cep\": \"<string>\",\n \"cidade\": \"<string>\",\n \"cnpj\": \"12ABC34501DE35\",\n \"cpf\": \"12345678901\",\n \"email\": \"<string>\",\n \"logradouro\": \"<string>\",\n \"nome\": \"Fulano de Tal\",\n \"uf\": \"<string>\"\n },\n \"infoAdicionais\": [\n {\n \"nome\": \"<string>\",\n \"valor\": \"<string>\"\n }\n ],\n \"loc\": {\n \"id\": 123\n },\n \"solicitacaoPagador\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://spi.sandbox.lerian.net/api/v1/brcode/cob")
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 \"calendario\": {\n \"expiracao\": 3600\n },\n \"chave\": \"pix@lerian.studio\",\n \"valor\": {\n \"original\": \"250.00\",\n \"modalidadeAlteracao\": 0,\n \"retirada\": {}\n },\n \"devedor\": {\n \"cep\": \"<string>\",\n \"cidade\": \"<string>\",\n \"cnpj\": \"12ABC34501DE35\",\n \"cpf\": \"12345678901\",\n \"email\": \"<string>\",\n \"logradouro\": \"<string>\",\n \"nome\": \"Fulano de Tal\",\n \"uf\": \"<string>\"\n },\n \"infoAdicionais\": [\n {\n \"nome\": \"<string>\",\n \"valor\": \"<string>\"\n }\n ],\n \"loc\": {\n \"id\": 123\n },\n \"solicitacaoPagador\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"calendario": {
"criacao": "<string>",
"expiracao": 123
},
"chave": "<string>",
"loc": {
"criacao": "<string>",
"id": 123,
"tipoCob": "cob",
"location": "<string>"
},
"location": "<string>",
"pixCopiaECola": "<string>",
"revisao": 123,
"status": "ATIVA",
"txid": "<string>",
"valor": {
"modalidadeAlteracao": 0,
"original": "250.00",
"retirada": {
"saque": {
"modalidadeAgente": "AGPSS",
"prestadorDoServicoDeSaque": "12345678",
"valor": "5.00",
"modalidadeAlteracao": 0
},
"troco": {
"modalidadeAgente": "AGPSS",
"prestadorDoServicoDeSaque": "12345678",
"valor": "5.00",
"modalidadeAlteracao": 0
}
}
},
"devedor": {
"cep": "<string>",
"cidade": "<string>",
"cnpj": "12ABC34501DE35",
"cpf": "12345678901",
"email": "<string>",
"logradouro": "<string>",
"nome": "Fulano de Tal",
"uf": "<string>"
},
"infoAdicionais": [
{
"nome": "<string>",
"valor": "<string>"
}
],
"solicitacaoPagador": "<string>"
}{
"code": "ERR-0001",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Autorizações
JWT bearer token issued by the identity provider.
Cabeçalhos
Idempotency key, max 255 characters.
Corpo
Controle de tempo da cobrança.
Show child attributes
Show child attributes
Chave DICT do recebedor.
77"pix@lerian.studio"
Valores monetários da cobrança.
Show child attributes
Show child attributes
Devedor da cobrança (PF/PJ, opcional).
Show child attributes
Show child attributes
Informações adicionais (máx 50).
Show child attributes
Show child attributes
Referência de location.
Show child attributes
Show child attributes
Texto livre apresentado ao pagador.
140Resposta
Created
Show child attributes
Show child attributes
Chave DICT do recebedor.
77Show child attributes
Show child attributes
Localização do payload.
77Pix Copia e Cola (BR Code) correspondente à cobrança.
512Revisão da cobrança (inicia em 0).
Status do registro da cobrança.
ATIVA, CONCLUIDA, REMOVIDA_PELO_USUARIO_RECEBEDOR, REMOVIDA_PELO_PSP Identificador da transação.
[a-zA-Z0-9]{26,35}Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
140Esta página foi útil?

