Verificar confirmação do pedido
curl --request POST \
--url https://sandbox.4seletpay.com.br/api/v1/orders/{order_code}/confirmations/{confirmation_id}/verify \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'account: <account>' \
--data '
{
"code": "123456"
}
'import requests
url = "https://sandbox.4seletpay.com.br/api/v1/orders/{order_code}/confirmations/{confirmation_id}/verify"
payload = { "code": "123456" }
headers = {
"account": "<account>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
account: '<account>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({code: '123456'})
};
fetch('https://sandbox.4seletpay.com.br/api/v1/orders/{order_code}/confirmations/{confirmation_id}/verify', 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://sandbox.4seletpay.com.br/api/v1/orders/{order_code}/confirmations/{confirmation_id}/verify",
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([
'code' => '123456'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"account: <account>"
],
]);
$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://sandbox.4seletpay.com.br/api/v1/orders/{order_code}/confirmations/{confirmation_id}/verify"
payload := strings.NewReader("{\n \"code\": \"123456\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("account", "<account>")
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://sandbox.4seletpay.com.br/api/v1/orders/{order_code}/confirmations/{confirmation_id}/verify")
.header("account", "<account>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"code\": \"123456\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.4seletpay.com.br/api/v1/orders/{order_code}/confirmations/{confirmation_id}/verify")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["account"] = '<account>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"code\": \"123456\"\n}"
response = http.request(request)
puts response.read_body{
"mensagem": "Cobrança realizada com sucesso.",
"erro": false,
"mensagenserro": [],
"codigoretorno": 201,
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"data": {
"charge_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"charge_created_at": "11/03/2026 10:00:00",
"account_id": 1,
"code": "pur_abc123xyz",
"value": 199.8,
"charge_value": 199.8,
"coin": "BRL",
"status": "Approved",
"client": {
"code": "cli_abc123",
"name": "João Silva",
"email": "joao@exemplo.com.br",
"documents": [
{
"type": "CPF",
"number": "123.456.789-09",
"default": true
}
],
"phone": [
{
"ddi": "55",
"ddd": "11",
"number": "999999999",
"default": true
}
],
"addresss": [
{
"zipcode": "01310-100",
"street": "Avenida Paulista",
"number": "1000",
"neighborhood": "Bela Vista",
"city": "São Paulo",
"state": "SP"
}
]
},
"orders": [
{
"code": "ord_abc123xyz",
"status": "Approved",
"value": 199.8,
"error_message": null,
"items": [
{
"code": "produto_001",
"name": "Camiseta Premium",
"unitary_value": 99.9,
"quantity": 2
}
],
"charges": [
{
"code": "chg_abc123",
"status": "Approved",
"value": 199.8,
"canceled_amount": 0,
"nsu": "123456789",
"installments": 1,
"attempts": 1,
"payment": {
"code": null,
"copy_paste": null,
"expiration": null,
"payment_type": "CreditCard",
"installments": 1
},
"last_transaction": {
"transaction_id": "txn_abc123",
"type": "Authorization",
"status_code": "00",
"nsu": "123456789",
"tid": "tid_abc123",
"event_date": "2026-03-11T10:00:00.000000Z",
"order_code": "ord_abc123xyz",
"message_acquisition": "Transação autorizada",
"return_code": "00",
"return_message": "Sucesso",
"amount": 19980
},
"historics": [
{
"transaction_id": "<string>",
"type": "<string>",
"status_code": "<string>",
"nsu": "<string>",
"tid": "<string>",
"event_date": "2023-11-07T05:31:56Z",
"order_code": "<string>",
"message_acquisition": "<string>",
"return_code": "<string>",
"return_message": "<string>",
"operation_type": "<string>",
"amount": 123
}
],
"card": {
"id": "card_abc123",
"name": "JOAO SILVA",
"type": "credit",
"number": "411111****1111",
"flag": "visa"
}
}
],
"confirmation_codes": [
{
"id": "conf_xyz789",
"type": "OTP",
"status": "Pending",
"expires_at": "2026-03-11T10:15:00.000000Z"
}
]
}
]
}
}Pedidos
Verificar Confirmação
Verifica/valida uma confirmação de pedido desafiado submetendo o código OTP recebido pelo cliente. Ao confirmar com sucesso, as cobranças pendentes do pedido são processadas. A resposta segue o mesmo formato da criação de cobrança (envelope APIReturnUtil com dados de consulta).
POST
/
v1
/
orders
/
{order_code}
/
confirmations
/
{confirmation_id}
/
verify
Verificar confirmação do pedido
curl --request POST \
--url https://sandbox.4seletpay.com.br/api/v1/orders/{order_code}/confirmations/{confirmation_id}/verify \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'account: <account>' \
--data '
{
"code": "123456"
}
'import requests
url = "https://sandbox.4seletpay.com.br/api/v1/orders/{order_code}/confirmations/{confirmation_id}/verify"
payload = { "code": "123456" }
headers = {
"account": "<account>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
account: '<account>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({code: '123456'})
};
fetch('https://sandbox.4seletpay.com.br/api/v1/orders/{order_code}/confirmations/{confirmation_id}/verify', 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://sandbox.4seletpay.com.br/api/v1/orders/{order_code}/confirmations/{confirmation_id}/verify",
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([
'code' => '123456'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"account: <account>"
],
]);
$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://sandbox.4seletpay.com.br/api/v1/orders/{order_code}/confirmations/{confirmation_id}/verify"
payload := strings.NewReader("{\n \"code\": \"123456\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("account", "<account>")
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://sandbox.4seletpay.com.br/api/v1/orders/{order_code}/confirmations/{confirmation_id}/verify")
.header("account", "<account>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"code\": \"123456\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.4seletpay.com.br/api/v1/orders/{order_code}/confirmations/{confirmation_id}/verify")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["account"] = '<account>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"code\": \"123456\"\n}"
response = http.request(request)
puts response.read_body{
"mensagem": "Cobrança realizada com sucesso.",
"erro": false,
"mensagenserro": [],
"codigoretorno": 201,
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"data": {
"charge_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"charge_created_at": "11/03/2026 10:00:00",
"account_id": 1,
"code": "pur_abc123xyz",
"value": 199.8,
"charge_value": 199.8,
"coin": "BRL",
"status": "Approved",
"client": {
"code": "cli_abc123",
"name": "João Silva",
"email": "joao@exemplo.com.br",
"documents": [
{
"type": "CPF",
"number": "123.456.789-09",
"default": true
}
],
"phone": [
{
"ddi": "55",
"ddd": "11",
"number": "999999999",
"default": true
}
],
"addresss": [
{
"zipcode": "01310-100",
"street": "Avenida Paulista",
"number": "1000",
"neighborhood": "Bela Vista",
"city": "São Paulo",
"state": "SP"
}
]
},
"orders": [
{
"code": "ord_abc123xyz",
"status": "Approved",
"value": 199.8,
"error_message": null,
"items": [
{
"code": "produto_001",
"name": "Camiseta Premium",
"unitary_value": 99.9,
"quantity": 2
}
],
"charges": [
{
"code": "chg_abc123",
"status": "Approved",
"value": 199.8,
"canceled_amount": 0,
"nsu": "123456789",
"installments": 1,
"attempts": 1,
"payment": {
"code": null,
"copy_paste": null,
"expiration": null,
"payment_type": "CreditCard",
"installments": 1
},
"last_transaction": {
"transaction_id": "txn_abc123",
"type": "Authorization",
"status_code": "00",
"nsu": "123456789",
"tid": "tid_abc123",
"event_date": "2026-03-11T10:00:00.000000Z",
"order_code": "ord_abc123xyz",
"message_acquisition": "Transação autorizada",
"return_code": "00",
"return_message": "Sucesso",
"amount": 19980
},
"historics": [
{
"transaction_id": "<string>",
"type": "<string>",
"status_code": "<string>",
"nsu": "<string>",
"tid": "<string>",
"event_date": "2023-11-07T05:31:56Z",
"order_code": "<string>",
"message_acquisition": "<string>",
"return_code": "<string>",
"return_message": "<string>",
"operation_type": "<string>",
"amount": 123
}
],
"card": {
"id": "card_abc123",
"name": "JOAO SILVA",
"type": "credit",
"number": "411111****1111",
"flag": "visa"
}
}
],
"confirmation_codes": [
{
"id": "conf_xyz789",
"type": "OTP",
"status": "Pending",
"expires_at": "2026-03-11T10:15:00.000000Z"
}
]
}
]
}
}Requer o header
account. Submete o código OTP recebido pelo cliente para desbloquear o pedido e processar as cobranças pendentes.O código de verificação tem prazo de expiração (15 minutos). Se o prazo expirou, use a rota
/resend para solicitar um novo código.Ao confirmar com sucesso, as cobranças pendentes/desafiadas do pedido são processadas automaticamente.
A resposta segue o mesmo formato da criação de cobrança (HTTP 201 com dados da cobrança no campo
data).Authorizations
Token JWT obtido via POST /v1/login. Envie no header Authorization: Bearer <token>.
Headers
Código da conta à qual a operação se aplica
Example:
"acc_abc123xyz"
Path Parameters
Código único do pedido
Example:
"ord_abc123xyz"
ID (UUID) da confirmação a ser verificada
Example:
"d5e6f7a8-b9c0-1234-5678-abcdef012345"
Body
application/json
Código de verificação OTP recebido pelo cliente
Example:
"123456"
Response
Cobrança processada com sucesso após confirmação
Resposta da criação de cobrança (envelope APIReturnUtil + dados ConsultCharge)
Example:
"Cobrança realizada com sucesso."
Example:
false
Example:
[]
Example:
201
ID da cobrança criada
Example:
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
Dados completos de uma cobrança retornados pelo ConsultCharge
Show child attributes
Show child attributes