Criar transferência
curl --request POST \
--url https://api.upag.io/v1/transfers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"pixKey": "<string>",
"pixKeyType": "<string>",
"amount": 123
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({pixKey: '<string>', pixKeyType: '<string>', amount: 123})
};
fetch('https://api.upag.io/v1/transfers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.upag.io/v1/transfers';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({pixKey: '<string>', pixKeyType: '<string>', amount: 123})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));Transferências
Criar transferência
Envia Pix pela chave de API (sem PIN)
POST
https://api.upag.io
/
v1
/
transfers
Criar transferência
curl --request POST \
--url https://api.upag.io/v1/transfers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"pixKey": "<string>",
"pixKeyType": "<string>",
"amount": 123
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({pixKey: '<string>', pixKeyType: '<string>', amount: 123})
};
fetch('https://api.upag.io/v1/transfers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.upag.io/v1/transfers';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({pixKey: '<string>', pixKeyType: '<string>', amount: 123})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));Com chave secreta, Pix-out não exige PIN. Valores em centavos.
O valor é lido do QR; não envie Parâmetros (
Endpoint — chave Pix
curl -X POST https://api.upag.io/v1/transfers \
-H "Authorization: Bearer sk_test_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"type": "key",
"pixKey": "55ce1aae-0d2b-4d76-bc77-294d6407349e",
"pixKeyType": "random",
"amount": 100,
"description": "Pagamento fornecedor"
}'
Endpoint — copia-e-cola
curl -X POST https://api.upag.io/v1/transfers \
-H "Authorization: Bearer sk_test_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"type": "hash",
"hash": "00020126580014br.gov.bcb.pix..."
}'
amount para hash.
Parâmetros (type: key)
string
required
Chave Pix de destino.
string
required
email, phone, cpf, cnpj ou random.integer
required
Valor em centavos.
string
Até 140 caracteres.
string
Data de pagamento (quando aplicável ao provedor).
Resposta
201 Created
Response
{
"id": "770e8400-e29b-41d4-a716-446655440000",
"status": "processing",
"direction": "out",
"type": "key",
"amount": 100,
"pixKey": "55ce1aae-0d2b-4d76-bc77-294d6407349e",
"pixKeyType": "random",
"from": {
"name": "Acme LTDA",
"taxNumber": "12.345.678/0001-99",
"bankName": "Upag"
},
"to": {
"name": "Maria Receiver",
"taxNumber": "111.444.777-35",
"bankName": "FitBank"
},
"endToEndId": null,
"providerTransactionId": "555",
"url": null,
"createdAt": "2026-03-18T12:00:00.000Z",
"updatedAt": "2026-03-18T12:00:00.000Z",
"transaction": {
"id": "880e8400-e29b-41d4-a716-446655440000",
"entryType": "debit",
"amount": 100,
"description": null,
"endToEndId": null,
"availableAt": null,
"source": {
"type": "transfer",
"id": "770e8400-e29b-41d4-a716-446655440000"
},
"createdAt": "2026-03-18T12:00:00.000Z"
}
}