cURL
curl --request POST \
--url https://sandbox-api.superpagamentos.com/payments \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"paymentType": "card",
"billingData": {
"amount": 10000,
"installments": 1,
"postbackUrl": "https://example.com/callback"
},
"customerData": {
"remoteIpv4": "192.168.1.1",
"firstName": "João",
"lastName": "Silva",
"document": "12345678909",
"email": "joao.silva@email.com",
"address": {
"street": "Rua das Flores",
"streetNumber": 123,
"neighborhood": "Centro",
"city": "São Paulo",
"state": "SP",
"zipcode": "01234567",
"complement": "Apto 123",
"reference": "Próximo ao shopping"
},
"phone": "11999999999"
},
"cardData": {
"cardNumber": "4532650104137832",
"holderName": "João Silva",
"expirationMonth": "12",
"expirationYear": "2024",
"securityCode": "123"
},
"splits": [
{
"subaccountId": "beff457d-e893-49df-8395-e8b67ab21e7c",
"chargebackLiable": true,
"splitPercentage": 10,
"splitAmount": 450
}
]
}
'import requests
url = "https://sandbox-api.superpagamentos.com/payments"
payload = {
"paymentType": "card",
"billingData": {
"amount": 10000,
"installments": 1,
"postbackUrl": "https://example.com/callback"
},
"customerData": {
"remoteIpv4": "192.168.1.1",
"firstName": "João",
"lastName": "Silva",
"document": "12345678909",
"email": "joao.silva@email.com",
"address": {
"street": "Rua das Flores",
"streetNumber": 123,
"neighborhood": "Centro",
"city": "São Paulo",
"state": "SP",
"zipcode": "01234567",
"complement": "Apto 123",
"reference": "Próximo ao shopping"
},
"phone": "11999999999"
},
"cardData": {
"cardNumber": "4532650104137832",
"holderName": "João Silva",
"expirationMonth": "12",
"expirationYear": "2024",
"securityCode": "123"
},
"splits": [
{
"subaccountId": "beff457d-e893-49df-8395-e8b67ab21e7c",
"chargebackLiable": True,
"splitPercentage": 10,
"splitAmount": 450
}
]
}
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({
paymentType: 'card',
billingData: {amount: 10000, installments: 1, postbackUrl: 'https://example.com/callback'},
customerData: {
remoteIpv4: '192.168.1.1',
firstName: 'João',
lastName: 'Silva',
document: '12345678909',
email: 'joao.silva@email.com',
address: {
street: 'Rua das Flores',
streetNumber: 123,
neighborhood: 'Centro',
city: 'São Paulo',
state: 'SP',
zipcode: '01234567',
complement: 'Apto 123',
reference: 'Próximo ao shopping'
},
phone: '11999999999'
},
cardData: {
cardNumber: '4532650104137832',
holderName: 'João Silva',
expirationMonth: '12',
expirationYear: '2024',
securityCode: '123'
},
splits: [
{
subaccountId: 'beff457d-e893-49df-8395-e8b67ab21e7c',
chargebackLiable: true,
splitPercentage: 10,
splitAmount: 450
}
]
})
};
fetch('https://sandbox-api.superpagamentos.com/payments', 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-api.superpagamentos.com/payments",
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([
'paymentType' => 'card',
'billingData' => [
'amount' => 10000,
'installments' => 1,
'postbackUrl' => 'https://example.com/callback'
],
'customerData' => [
'remoteIpv4' => '192.168.1.1',
'firstName' => 'João',
'lastName' => 'Silva',
'document' => '12345678909',
'email' => 'joao.silva@email.com',
'address' => [
'street' => 'Rua das Flores',
'streetNumber' => 123,
'neighborhood' => 'Centro',
'city' => 'São Paulo',
'state' => 'SP',
'zipcode' => '01234567',
'complement' => 'Apto 123',
'reference' => 'Próximo ao shopping'
],
'phone' => '11999999999'
],
'cardData' => [
'cardNumber' => '4532650104137832',
'holderName' => 'João Silva',
'expirationMonth' => '12',
'expirationYear' => '2024',
'securityCode' => '123'
],
'splits' => [
[
'subaccountId' => 'beff457d-e893-49df-8395-e8b67ab21e7c',
'chargebackLiable' => true,
'splitPercentage' => 10,
'splitAmount' => 450
]
]
]),
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://sandbox-api.superpagamentos.com/payments"
payload := strings.NewReader("{\n \"paymentType\": \"card\",\n \"billingData\": {\n \"amount\": 10000,\n \"installments\": 1,\n \"postbackUrl\": \"https://example.com/callback\"\n },\n \"customerData\": {\n \"remoteIpv4\": \"192.168.1.1\",\n \"firstName\": \"João\",\n \"lastName\": \"Silva\",\n \"document\": \"12345678909\",\n \"email\": \"joao.silva@email.com\",\n \"address\": {\n \"street\": \"Rua das Flores\",\n \"streetNumber\": 123,\n \"neighborhood\": \"Centro\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"zipcode\": \"01234567\",\n \"complement\": \"Apto 123\",\n \"reference\": \"Próximo ao shopping\"\n },\n \"phone\": \"11999999999\"\n },\n \"cardData\": {\n \"cardNumber\": \"4532650104137832\",\n \"holderName\": \"João Silva\",\n \"expirationMonth\": \"12\",\n \"expirationYear\": \"2024\",\n \"securityCode\": \"123\"\n },\n \"splits\": [\n {\n \"subaccountId\": \"beff457d-e893-49df-8395-e8b67ab21e7c\",\n \"chargebackLiable\": true,\n \"splitPercentage\": 10,\n \"splitAmount\": 450\n }\n ]\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://sandbox-api.superpagamentos.com/payments")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"paymentType\": \"card\",\n \"billingData\": {\n \"amount\": 10000,\n \"installments\": 1,\n \"postbackUrl\": \"https://example.com/callback\"\n },\n \"customerData\": {\n \"remoteIpv4\": \"192.168.1.1\",\n \"firstName\": \"João\",\n \"lastName\": \"Silva\",\n \"document\": \"12345678909\",\n \"email\": \"joao.silva@email.com\",\n \"address\": {\n \"street\": \"Rua das Flores\",\n \"streetNumber\": 123,\n \"neighborhood\": \"Centro\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"zipcode\": \"01234567\",\n \"complement\": \"Apto 123\",\n \"reference\": \"Próximo ao shopping\"\n },\n \"phone\": \"11999999999\"\n },\n \"cardData\": {\n \"cardNumber\": \"4532650104137832\",\n \"holderName\": \"João Silva\",\n \"expirationMonth\": \"12\",\n \"expirationYear\": \"2024\",\n \"securityCode\": \"123\"\n },\n \"splits\": [\n {\n \"subaccountId\": \"beff457d-e893-49df-8395-e8b67ab21e7c\",\n \"chargebackLiable\": true,\n \"splitPercentage\": 10,\n \"splitAmount\": 450\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox-api.superpagamentos.com/payments")
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 \"paymentType\": \"card\",\n \"billingData\": {\n \"amount\": 10000,\n \"installments\": 1,\n \"postbackUrl\": \"https://example.com/callback\"\n },\n \"customerData\": {\n \"remoteIpv4\": \"192.168.1.1\",\n \"firstName\": \"João\",\n \"lastName\": \"Silva\",\n \"document\": \"12345678909\",\n \"email\": \"joao.silva@email.com\",\n \"address\": {\n \"street\": \"Rua das Flores\",\n \"streetNumber\": 123,\n \"neighborhood\": \"Centro\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"zipcode\": \"01234567\",\n \"complement\": \"Apto 123\",\n \"reference\": \"Próximo ao shopping\"\n },\n \"phone\": \"11999999999\"\n },\n \"cardData\": {\n \"cardNumber\": \"4532650104137832\",\n \"holderName\": \"João Silva\",\n \"expirationMonth\": \"12\",\n \"expirationYear\": \"2024\",\n \"securityCode\": \"123\"\n },\n \"splits\": [\n {\n \"subaccountId\": \"beff457d-e893-49df-8395-e8b67ab21e7c\",\n \"chargebackLiable\": true,\n \"splitPercentage\": 10,\n \"splitAmount\": 450\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "4309e70d-fa20-4103-84c6-27370138948b",
"status": "SUCCEEDED",
"paymentMethod": "card",
"currency": "BRL",
"amount": 10000,
"postbackUrl": "",
"installments": 10,
"buyerDetails": {
"firstName": "João",
"lastName": "Silva",
"email": "joao.silva@email.com",
"document": "12345678909",
"phone": null,
"street": "Rua das Flores",
"streetNumber": 123,
"neighborhood": "Centro",
"complement": null,
"reference": null,
"city": "São Paulo",
"state": "SP"
},
"cardDetails": {
"brand": "Visa",
"first4Digits": "4532",
"last4Digits": "7832",
"expirationMonth": "12",
"expirationYear": "2024"
},
"splits": [
{
"subaccountId": "beff457d-e893-49df-8395-e8b67ab21e7c",
"splitType": "percentage",
"splitPercentage": 29.33,
"liquidAmount": 2933,
"chargebackLiable": false
}
],
"createdAt": "2025-06-09T19:14:20.125Z",
"updatedAt": "2025-06-09T19:14:20.125Z"
},
"message": "Pagamento criado com sucesso"
}Transações
Gerar transação
Cria uma nova transação no método de pagamento selecionado. Essa rota pode ser utilizada para criar transações com cartão de crédito, cartão tokenizado, PIX e boleto. Também é possível realizar splits entre subcontas.
Tipos de pagamento disponíveis:
- Cartão de Crédito: Pagamento direto com cartão de crédito, requerendo dados completos do cliente, endereço e cartão
- Cartão Tokenizado: Pagamento com cartão de crédito previamente tokenizado
- PIX: Pagamento instantâneo via PIX
- Boleto: Geração de boleto bancário
POST
/
payments
cURL
curl --request POST \
--url https://sandbox-api.superpagamentos.com/payments \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"paymentType": "card",
"billingData": {
"amount": 10000,
"installments": 1,
"postbackUrl": "https://example.com/callback"
},
"customerData": {
"remoteIpv4": "192.168.1.1",
"firstName": "João",
"lastName": "Silva",
"document": "12345678909",
"email": "joao.silva@email.com",
"address": {
"street": "Rua das Flores",
"streetNumber": 123,
"neighborhood": "Centro",
"city": "São Paulo",
"state": "SP",
"zipcode": "01234567",
"complement": "Apto 123",
"reference": "Próximo ao shopping"
},
"phone": "11999999999"
},
"cardData": {
"cardNumber": "4532650104137832",
"holderName": "João Silva",
"expirationMonth": "12",
"expirationYear": "2024",
"securityCode": "123"
},
"splits": [
{
"subaccountId": "beff457d-e893-49df-8395-e8b67ab21e7c",
"chargebackLiable": true,
"splitPercentage": 10,
"splitAmount": 450
}
]
}
'import requests
url = "https://sandbox-api.superpagamentos.com/payments"
payload = {
"paymentType": "card",
"billingData": {
"amount": 10000,
"installments": 1,
"postbackUrl": "https://example.com/callback"
},
"customerData": {
"remoteIpv4": "192.168.1.1",
"firstName": "João",
"lastName": "Silva",
"document": "12345678909",
"email": "joao.silva@email.com",
"address": {
"street": "Rua das Flores",
"streetNumber": 123,
"neighborhood": "Centro",
"city": "São Paulo",
"state": "SP",
"zipcode": "01234567",
"complement": "Apto 123",
"reference": "Próximo ao shopping"
},
"phone": "11999999999"
},
"cardData": {
"cardNumber": "4532650104137832",
"holderName": "João Silva",
"expirationMonth": "12",
"expirationYear": "2024",
"securityCode": "123"
},
"splits": [
{
"subaccountId": "beff457d-e893-49df-8395-e8b67ab21e7c",
"chargebackLiable": True,
"splitPercentage": 10,
"splitAmount": 450
}
]
}
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({
paymentType: 'card',
billingData: {amount: 10000, installments: 1, postbackUrl: 'https://example.com/callback'},
customerData: {
remoteIpv4: '192.168.1.1',
firstName: 'João',
lastName: 'Silva',
document: '12345678909',
email: 'joao.silva@email.com',
address: {
street: 'Rua das Flores',
streetNumber: 123,
neighborhood: 'Centro',
city: 'São Paulo',
state: 'SP',
zipcode: '01234567',
complement: 'Apto 123',
reference: 'Próximo ao shopping'
},
phone: '11999999999'
},
cardData: {
cardNumber: '4532650104137832',
holderName: 'João Silva',
expirationMonth: '12',
expirationYear: '2024',
securityCode: '123'
},
splits: [
{
subaccountId: 'beff457d-e893-49df-8395-e8b67ab21e7c',
chargebackLiable: true,
splitPercentage: 10,
splitAmount: 450
}
]
})
};
fetch('https://sandbox-api.superpagamentos.com/payments', 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-api.superpagamentos.com/payments",
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([
'paymentType' => 'card',
'billingData' => [
'amount' => 10000,
'installments' => 1,
'postbackUrl' => 'https://example.com/callback'
],
'customerData' => [
'remoteIpv4' => '192.168.1.1',
'firstName' => 'João',
'lastName' => 'Silva',
'document' => '12345678909',
'email' => 'joao.silva@email.com',
'address' => [
'street' => 'Rua das Flores',
'streetNumber' => 123,
'neighborhood' => 'Centro',
'city' => 'São Paulo',
'state' => 'SP',
'zipcode' => '01234567',
'complement' => 'Apto 123',
'reference' => 'Próximo ao shopping'
],
'phone' => '11999999999'
],
'cardData' => [
'cardNumber' => '4532650104137832',
'holderName' => 'João Silva',
'expirationMonth' => '12',
'expirationYear' => '2024',
'securityCode' => '123'
],
'splits' => [
[
'subaccountId' => 'beff457d-e893-49df-8395-e8b67ab21e7c',
'chargebackLiable' => true,
'splitPercentage' => 10,
'splitAmount' => 450
]
]
]),
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://sandbox-api.superpagamentos.com/payments"
payload := strings.NewReader("{\n \"paymentType\": \"card\",\n \"billingData\": {\n \"amount\": 10000,\n \"installments\": 1,\n \"postbackUrl\": \"https://example.com/callback\"\n },\n \"customerData\": {\n \"remoteIpv4\": \"192.168.1.1\",\n \"firstName\": \"João\",\n \"lastName\": \"Silva\",\n \"document\": \"12345678909\",\n \"email\": \"joao.silva@email.com\",\n \"address\": {\n \"street\": \"Rua das Flores\",\n \"streetNumber\": 123,\n \"neighborhood\": \"Centro\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"zipcode\": \"01234567\",\n \"complement\": \"Apto 123\",\n \"reference\": \"Próximo ao shopping\"\n },\n \"phone\": \"11999999999\"\n },\n \"cardData\": {\n \"cardNumber\": \"4532650104137832\",\n \"holderName\": \"João Silva\",\n \"expirationMonth\": \"12\",\n \"expirationYear\": \"2024\",\n \"securityCode\": \"123\"\n },\n \"splits\": [\n {\n \"subaccountId\": \"beff457d-e893-49df-8395-e8b67ab21e7c\",\n \"chargebackLiable\": true,\n \"splitPercentage\": 10,\n \"splitAmount\": 450\n }\n ]\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://sandbox-api.superpagamentos.com/payments")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"paymentType\": \"card\",\n \"billingData\": {\n \"amount\": 10000,\n \"installments\": 1,\n \"postbackUrl\": \"https://example.com/callback\"\n },\n \"customerData\": {\n \"remoteIpv4\": \"192.168.1.1\",\n \"firstName\": \"João\",\n \"lastName\": \"Silva\",\n \"document\": \"12345678909\",\n \"email\": \"joao.silva@email.com\",\n \"address\": {\n \"street\": \"Rua das Flores\",\n \"streetNumber\": 123,\n \"neighborhood\": \"Centro\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"zipcode\": \"01234567\",\n \"complement\": \"Apto 123\",\n \"reference\": \"Próximo ao shopping\"\n },\n \"phone\": \"11999999999\"\n },\n \"cardData\": {\n \"cardNumber\": \"4532650104137832\",\n \"holderName\": \"João Silva\",\n \"expirationMonth\": \"12\",\n \"expirationYear\": \"2024\",\n \"securityCode\": \"123\"\n },\n \"splits\": [\n {\n \"subaccountId\": \"beff457d-e893-49df-8395-e8b67ab21e7c\",\n \"chargebackLiable\": true,\n \"splitPercentage\": 10,\n \"splitAmount\": 450\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox-api.superpagamentos.com/payments")
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 \"paymentType\": \"card\",\n \"billingData\": {\n \"amount\": 10000,\n \"installments\": 1,\n \"postbackUrl\": \"https://example.com/callback\"\n },\n \"customerData\": {\n \"remoteIpv4\": \"192.168.1.1\",\n \"firstName\": \"João\",\n \"lastName\": \"Silva\",\n \"document\": \"12345678909\",\n \"email\": \"joao.silva@email.com\",\n \"address\": {\n \"street\": \"Rua das Flores\",\n \"streetNumber\": 123,\n \"neighborhood\": \"Centro\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"zipcode\": \"01234567\",\n \"complement\": \"Apto 123\",\n \"reference\": \"Próximo ao shopping\"\n },\n \"phone\": \"11999999999\"\n },\n \"cardData\": {\n \"cardNumber\": \"4532650104137832\",\n \"holderName\": \"João Silva\",\n \"expirationMonth\": \"12\",\n \"expirationYear\": \"2024\",\n \"securityCode\": \"123\"\n },\n \"splits\": [\n {\n \"subaccountId\": \"beff457d-e893-49df-8395-e8b67ab21e7c\",\n \"chargebackLiable\": true,\n \"splitPercentage\": 10,\n \"splitAmount\": 450\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "4309e70d-fa20-4103-84c6-27370138948b",
"status": "SUCCEEDED",
"paymentMethod": "card",
"currency": "BRL",
"amount": 10000,
"postbackUrl": "",
"installments": 10,
"buyerDetails": {
"firstName": "João",
"lastName": "Silva",
"email": "joao.silva@email.com",
"document": "12345678909",
"phone": null,
"street": "Rua das Flores",
"streetNumber": 123,
"neighborhood": "Centro",
"complement": null,
"reference": null,
"city": "São Paulo",
"state": "SP"
},
"cardDetails": {
"brand": "Visa",
"first4Digits": "4532",
"last4Digits": "7832",
"expirationMonth": "12",
"expirationYear": "2024"
},
"splits": [
{
"subaccountId": "beff457d-e893-49df-8395-e8b67ab21e7c",
"splitType": "percentage",
"splitPercentage": 29.33,
"liquidAmount": 2933,
"chargebackLiable": false
}
],
"createdAt": "2025-06-09T19:14:20.125Z",
"updatedAt": "2025-06-09T19:14:20.125Z"
},
"message": "Pagamento criado com sucesso"
}Authorizations
Token JWT gerado na rota de autenticação (/auth). Deve ser enviado no formato: Bearer
Body
application/json
Payload para criação de um novo pagamento. O tipo de pagamento determina a estrutura específica dos dados necessários.
- Cartão de crédito
- Cartão de Crédito Tokenizado
- PIX
- Boleto
Método de pagamento a ser utilizado
Available options:
card Dados de faturamento do pagamento
Show child attributes
Show child attributes
Dados do cliente
Show child attributes
Show child attributes
Dados do cartão de crédito
Show child attributes
Show child attributes
Configuração de splits do pagamento (opcional)
Show child attributes
Show child attributes