Iniciar el pago por PIX
curl --request POST \
--url https://api.vertracloud.app/v1/orders/{orderId}/initiate/pix \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/orders/{orderId}/initiate/pix', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/orders/{orderId}/initiate/pix"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/orders/{orderId}/initiate/pix"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": {
"transaction_amount": 24.9,
"external_reference": "order-abc123",
"txid": "9c2b1e3a-...-000",
"expires_at": "2026-10-13T15:30:00.000Z",
"qrcode": {
"copy": "00020126...6304ABCD",
"base64": "iVBORw0KGgoAAAANSUhEUgAA..."
}
}
}
Facturación
Iniciar el pago por PIX
Genera el cargo PIX (código QR) de un pedido pendiente de pago.
POST
/
v1
/
orders
/
{orderId}
/
initiate
/
pix
Iniciar el pago por PIX
curl --request POST \
--url https://api.vertracloud.app/v1/orders/{orderId}/initiate/pix \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/orders/{orderId}/initiate/pix', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/orders/{orderId}/initiate/pix"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/orders/{orderId}/initiate/pix"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": {
"transaction_amount": 24.9,
"external_reference": "order-abc123",
"txid": "9c2b1e3a-...-000",
"expires_at": "2026-10-13T15:30:00.000Z",
"qrcode": {
"copy": "00020126...6304ABCD",
"base64": "iVBORw0KGgoAAAANSUhEUgAA..."
}
}
}
string
requerido
El ID del pedido.
expires_at), y nunca más allá del vencimiento del propio pedido.
Si vuelves a llamar mientras el código QR sigue siendo válido, se devuelve el mismo. Cuando caduca,
si vuelves a llamar mientras el pedido sigue abierto, se devuelve un código QR nuevo para el mismo pedido.
Respuesta
object
Mostrar Mostrar objeto
Mostrar Mostrar objeto
number
El importe del cargo, en BRL.
string | null
El ID del pedido, devuelto como referencia externa del pago.
string
El ID de la transacción PIX.
string | null
Cuándo deja de poder pagarse este código QR, en ISO 8601 (hasta 30 minutos después de generarse, nunca después de que caduque el pedido).
{
"response": {
"transaction_amount": 24.9,
"external_reference": "order-abc123",
"txid": "9c2b1e3a-...-000",
"expires_at": "2026-10-13T15:30:00.000Z",
"qrcode": {
"copy": "00020126...6304ABCD",
"base64": "iVBORw0KGgoAAAANSUhEUgAA..."
}
}
}
Respuestas de error
string
El código de error que indica el motivo del fallo. Valores posibles:
AUTH_TOKEN_MISSING,API_KEY_INVALID,SESSION_REVOKED: Falta la cabeceraAuthorization, la clave de API no es válida o la sesión del panel fue revocada (401).API_KEY_IP_DENIED,API_KEY_SCOPE_DENIED: La clave de API se usa desde una IP fuera de su lista de permitidas, o no tiene el scope que requiere la ruta (403).USER_NOT_FOUND: No se encontró el usuario autenticado.ORDER_NOT_FOUND: El pedido indicado no existe.FORBIDDEN: El pedido no pertenece al usuario autenticado.ORDER_NOT_PAYABLE: El pedido ya está pagado, cancelado o caducado (400), o todavía se está confirmando un pago con tarjeta del pedido (409).COUPON_PAYMENT_METHOD: El cupón del pedido no permite PIX.PAYMENT_METHOD_UNAVAILABLE: El pago en línea no está disponible temporalmente.INVALID_PARAMS: ElorderIdtiene un formato incorrecto.RATE_LIMIT_EXCEEDED: Se está iniciando otro pago de la cuenta. Vuelve a intentarlo en breve.INTERNAL_SERVER_ERROR: Se produjo un error inesperado en el servidor.
{
"code": "ORDER_NOT_PAYABLE"
}
Última modificación el 28 de octubre de 2026