Criar Transação
POST
/api/user/transactions
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/user/transactions' \
--header 'x-api-key: {Token}' \
--header 'User-Agent: AtivoB2B/1.0' \
--header 'Content-Type: application/json' \
--data-raw '{
"pix": {
"expiresInDays": 1
},
"items": [
{
"title": "5600 Mais 1120 de bônus",
"quantity": 1,
"tangible": false,
"unitPrice": 1740, // pode ser qualquer valor, o que vale e o amount
"externalRef": "rn4RgQ1qR1MgwBV" //
}
],
"amount": 10000, // valor em centavos
"currency": "BRL",
"customer": {
"name": "Teste",
"email": "Outro@email.com",
"phone": "0999999999",
"document": {
"type": "CPF",
"number": "000000000"
}
},
"metadata": "",
"traceable": false,
"postbackUrl": "http://webhook.site/b5b9bdd0-a3f0-45b8-9ce2-0a867cb1c544", // link do webhook
"paymentMethod": "PIX"
}'Response Response Example
200 - Success
{
"status": 200,
"message": "Transação criada com sucesso.",
"data": {
"id": "00000000-0000-0000-0000-0000000000000",
"amount": 1000,
"paymentMethod": "BOLETO",
"refundedAmount": 0,
"installments": null,
"status": "WAITING_PAYMENT",
"postbackUrl": "https://meusite.com/postback",
"metadata": "{\"chave\":\"valor\"}",
"traceable": true,
"secureId": null,
"secureUrl": null,
"paidAt": null,
"ip": "192.168.1.1",
"externalRef": "pay_pr1rmhejz75wmrcp",
"endToEndId": null,
"externalNsu": null,
"releaseDate": null,
"refusedReason": null,
"provider": "Asaas",
"createdAt": "2025-04-16T14:47:46.428Z",
"updatedAt": "2025-04-16T14:47:48.034Z",
"gatewayId": "00000000-0000-0000-0000-0000000000000",
"companyId": "00000000-0000-0000-0000-0000000000000",
"customerId": "00000000-0000-0000-0000-0000000000000",
"cardId": null,
"gatewayProviderId": "00000000-0000-0000-0000-0000000000000",
"affiliatesId": null,
"anticipationId": null,
"gatewayDynamicPaymentMethodId": null,
"dynamicFields": null,
"returnUrl": null,
"currency": "BRL",
"qrCode": null,
"barcode": null,
"payUrl": null,
"webUrl": null,
"appUrl": null,
"boleto": {
"url": "https://sandbox.asaas.com/b/pdf/pr1rmhejz75wmrcp",
"barcode": null,
"digitableLine": null,
"instructions": null,
"expirationDate": "2025-04-23T00:00:00.000Z"
},
"card": null,
"pix": null,
"customer": {
"id": "000000-0000-0000-0000-0000000000000",
"externalRef": "string",
"name": "João da Silva",
"email": "johndoe@email.com",
"phone": "(11) 98765-4321",
"birthdate": null,
"createdAt": "2025-04-16T14:47:46.364Z",
"addressId": "000000000-0000-00000-0000-0000000000",
"document": {
"type": "CPF",
"number": "000000000000"
},
"address": {
"city": "São Paulo",
"state": "SP",
"street": "Avenida Paulista",
"country": "br",
"zipCode": "01000-000",
"complement": "Apto 101",
"neighborhood": "Bela Vista",
"streetNumber": "123"
}
},
"shipping": {
"fee": 500,
"address": {
"city": "São Paulo",
"state": "SP",
"street": "Avenida Paulista",
"country": "br",
"zipCode": "01000-000",
"complement": "Apto 101",
"neighborhood": "Bela Vista",
"streetNumber": "123"
}
},
"items": [
{
"title": "Produto XYZ",
"quantity": 1,
"tangible": true,
"unitPrice": 10,
"externalRef": "item-12345"
}
],
"delivery": {
"status": "WAITING",
"trackingCode": "N/A",
"createdAt": "2025-04-16T14:47:46.428Z"
},
"fee": {
"netAmount": 776,
"fixedAmount": 199,
"estimatedFee": 223.9,
"spreadPercentage": 2.49
},
"refunds": []
},
"error": null
}Request
Header Params
Body Params application/json
Responses
Modified at 2025-08-18 00:51:46