Get a Pix Transfer

Use this endpoint to retrieve a Pix transfer by its unique identifier.

GET /v1/transfers/{transfer_id}

Get a Pix Transfer

cURL

curl --request GET \
  --url https://api.example.com/v1/transfers/{transfer_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Account-Id: <x-account-id>'

200

{
  "accountId": "01989f9e-6508-79f8-9540-835be49fbd0d",
  "amount": "100.50",
  "createdAt": "2024-01-15T10:30:15Z",
  "endToEndId": "E1234567820240101000001234567890",
  "id": "550e8400-e29b-41d4-a716-446655440010",
  "initiationType": "KEY",
  "paymentType": "IMMEDIATE",
  "purpose": "TRANSFER",
  "status": "COMPLETED",
  "type": "CASHIN",
  "updatedAt": "2024-01-15T10:35:00Z",
  "urgency": "HIGH",
  "aliasId": "01989f9e-6508-79f8-9540-835be49fbd0e",
  "deletedAt": "<string>",
  "description": "Pix Cashin Transfer",
  "destination": {
    "account": {
      "branch": "0001",
      "number": "123456789",
      "participant": "12345678",
      "type": "TRAN"
    },
    "key": "[e-mail]",
    "owner": {
      "document": "12ABC34501DE35",
      "name": "John Doe",
      "type": "NATURAL_PERSON",
      "tradeName": "John's Business"
    }
  },
  "feeCharge": {
    "applied": true,
    "calculationType": "segment",
    "fees": [
      {
        "amount": "1.50",
        "calculationType": "PERCENTAGE",
        "calculationValue": "1.5",
        "creditAccount": "01989f9e-6508-79f8-9540-835be49fbd0d",
        "feeLabel": "PIX_FEE"
      }
    ],
    "netAmount": "97.50",
    "totalAmount": "2.50"
  },
  "initiatedAt": "2024-01-15T10:30:00Z",
  "ledger": {
    "destinationOperationId": "550e8400-e29b-41d4-a716-446655440013",
    "revert": {
      "destinationOperationId": "550e8400-e29b-41d4-a716-446655440016",
      "sourceOperationId": "550e8400-e29b-41d4-a716-446655440015",
      "transactionId": "550e8400-e29b-41d4-a716-446655440014"
    },
    "sourceOperationId": "550e8400-e29b-41d4-a716-446655440012",
    "transactionId": "550e8400-e29b-41d4-a716-446655440011"
  },
  "metadata": {},
  "source": {
    "account": {
      "branch": "0001",
      "number": "123456789",
      "participant": "12345678",
      "type": "TRAN"
    },
    "key": "[e-mail]",
    "owner": {
      "document": "12ABC34501DE35",
      "name": "John Doe",
      "type": "NATURAL_PERSON",
      "tradeName": "John's Business"
    }
  },
  "txId": "cob7f3a9c2e4b118d",
  "withdrawal": {
    "agentMode": "AGTEC",
    "withdrawalAmount": "50.00",
    "withdrawalServiceProvider": "12345678",
    "transactionAmount": "80.00"
  }
}

Autorizaciones

Authorization · string · header · requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Account-Id · string · requerido

Unique identifier of the Midaz Ledger Account (UUID format)

Parámetros de ruta

transfer_id · string · requerido

Transfer ID (UUID format)

Respuesta

200

application/json

OK

accountId · string · requerido

Ejemplo:

"01989f9e-6508-79f8-9540-835be49fbd0d"

amount · string · requerido

Ejemplo:

"100.50"

createdAt · string · requerido

Ejemplo:

"2024-01-15T10:30:15Z"

endToEndId · string · requerido

Ejemplo:

"E1234567820240101000001234567890"

id · string · requerido

Ejemplo:

"550e8400-e29b-41d4-a716-446655440010"

initiationType · enum<string> · requerido

Opciones disponibles: MANUAL, KEY, QR_CODE

Ejemplo:

"KEY"

paymentType · enum<string> · requerido

Opciones disponibles: IMMEDIATE, SCHEDULED

Ejemplo:

"IMMEDIATE"

purpose · enum<string> · requerido

Opciones disponibles: TRANSFER, INSTANT_PAYMENT_REFUND, CHANGE, WITHDRAWAL

Ejemplo:

"TRANSFER"

status · enum<string> · requerido

Opciones disponibles: CREATED, PENDING, PROCESSING, COMPLETED, FAILED, REVERSED

Ejemplo:

"COMPLETED"

type · enum<string> · requerido

Opciones disponibles: CASHIN, CASHOUT

Ejemplo:

"CASHIN"

updatedAt · string · requerido

Ejemplo:

"2024-01-15T10:35:00Z"

urgency · enum<string> · requerido

Opciones disponibles: HIGH, NORMAL

Ejemplo:

"HIGH"

aliasId · string

Ejemplo:

"01989f9e-6508-79f8-9540-835be49fbd0e"

deletedAt · string

description · string

Ejemplo:

"Pix Cashin Transfer"

destination · object

Show child attributes

feeCharge · object

Show child attributes

initiatedAt · string

Ejemplo:

"2024-01-15T10:30:00Z"

ledger · object

Show child attributes

metadata · object

Show child attributes

source · object

Show child attributes

txId · string

Transaction ID (txId) declared by the QR Code this cash-in paid. For a dynamic QR Code it is the charge's own txId, proven against that charge before the cash-in was accepted. For a static BR Code it is whatever reference label the code declared, which may match no charge. initiationType answers QR_CODE for both, so treat this as a correlation hint rather than proof a charge was paid. Absent for a payment with no QR Code and for every cash-out.

Ejemplo:

"cob7f3a9c2e4b118d"

withdrawal · object

Show child attributes