MagenMagen Docs
Endpoints da APICobranças Pix

Create Charge (Pix deposit)

POST
/pix

Authorization

BearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://api.magen.processamento.com/v1/pix" \  -H "Content-Type: application/json" \  -d '{    "amount": 10.9  }'
{
  "id": "MAGEN20250817215911F49RDOBJ",
  "status": "PENDING",
  "amount": 10,
  "type": "DEPOSIT",
  "callbackUrl": "https://webhook.cool/",
  "qrCodeText": "00020126870014br.gov.bcb.pix2565qrcode.magen.com.br/dynamic/d7790b91-3979-4ad5-9d96-ee941e5a42765204000053039865802BR5908MAGENPLUS6009SAO PAULO62070503***63047EE4",
  "qrCodeBase64": "iVBORw0KGgoAAAANSUhEUgAAAZAAAAGQCAYAAAC...",
  "qrCodeUrl": "https://pix.magen.com.br/v1/pix/qr-code/MAGEN20250817215911F49RDOBJ",
  "generatedName": "John Doe",
  "generatedDocument": "12345678901",
  "generatedEmail": "john.doe@example.com",
  "serviceFeeCharged": 0.115,
  "payerName": null,
  "payerDocument": null,
  "payerInstitutionIspb": null,
  "payerInstitutionName": null,
  "payerAccountNumber": null,
  "receiverName": null,
  "receiverDocument": null,
  "receiverInstitutionIspb": null,
  "receiverInstitutionName": null,
  "receiverAccountNumber": "513579",
  "endToEndId": null,
  "createdAt": "2025-08-17T21:59:11.579Z",
  "updatedAt": "2025-08-17T21:59:11.579Z",
  "paidAt": null,
  "withdrawPixKey": null,
  "withdrawPixType": null,
  "clientReference": "order_12345",
  "refundEndToEndId": null,
  "refundAmount": null,
  "refundStatus": null,
  "refundReason": null,
  "refundDescription": null,
  "refundedAt": null,
  "cancellationReason": null
}
{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "querystring/dateFrom Invalid input: expected string, received undefined",
  "requestId": "cmou00000abcdef01s6ghij1k2lm"
}
{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Missing or invalid Bearer token",
  "requestId": "cmou00000abcdef01s6ghij1k2lm"
}

Cobranças Pix

Endpoints para criar cobranças Pix dinâmicas (depósitos), consultar status, renderizar QR Code e baixar comprovante.

Retrieve Charge

Get the latest status and details for a Pix **deposit (charge)**. Provide **one** of `id`, `clientReference`, or `endToEndId`. Use apenas um destes parâmetros: id, clientReference, endToEndId. Combinar mais de um retorna erro.