curl --request PUT \
--url https://spi.sandbox.lerian.net/api/v1/brcode/cob/{txid} \
--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/{txid}"
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.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
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/{txid}', 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/{txid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
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/{txid}"
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("PUT", 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.put("https://spi.sandbox.lerian.net/api/v1/brcode/cob/{txid}")
.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/{txid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.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 idempotente)
Cria uma cobrança imediata (Cob) identificada pelo txid do caminho (idempotente). API Pix v2.9 PUT /cob/.
curl --request PUT \
--url https://spi.sandbox.lerian.net/api/v1/brcode/cob/{txid} \
--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/{txid}"
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.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
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/{txid}', 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/{txid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
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/{txid}"
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("PUT", 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.put("https://spi.sandbox.lerian.net/api/v1/brcode/cob/{txid}")
.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/{txid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.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.
Parâmetros de caminho
Identificador da transação [a-zA-Z0-9]{26,35}.
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?

