Skip to main content
GET
/
api
/
v1
/
meds
curl -X GET 'https://app.plowf.com/api/v1/meds?status=PROCESSING&per_page=20' \
  -H 'Authorization: Bearer seu_token_aqui'
{
  "data": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "pix_in_transaction": {
        "uuid": "660e8400-e29b-41d4-a716-446655440001",
        "initiation": {
          "sender": {
            "name": "João Silva",
            "document": "12345678900",
            "account_number": "12345678",
            "account_agency": "0001",
            "bank": {
              "code": "001",
              "name": "Banco Exemplo",
              "ispb": "00000000"
            },
            "account_type": "PAYMENT"
          },
          "receiver": {
            "name": "Empresa Exemplo LTDA",
            "document": "12345678000199",
            "account_number": "87654321",
            "account_agency": "0001",
            "bank": {
              "code": "002",
              "name": "Banco Recebedor",
              "ispb": "00000001"
            },
            "account_type": "CHECKING"
          },
          "txid": "txid123456789abcdef",
          "value": "150.00",
          "type": "QR_DYNAMIC",
          "pix_key": "770e8400-e29b-41d4-a716-446655440002",
          "additional_info": [
            {
              "name": "ID do pagamento",
              "value": "880e8400-e29b-41d4-a716-446655440003"
            }
          ],
          "status": "COMPLETED",
          "expires_at": "2024-01-02T23:59:59.000000Z",
          "created_at": "2024-01-01T10:00:00.000000Z",
          "updated_at": "2024-01-01T10:05:00.000000Z"
        },
        "value": "150.00",
        "movement_type": "IN",
        "type": "EXTERNAL_TRANSFER",
        "status": "SETTLED",
        "end_to_end": "E00000000202401011000abcdef12345",
        "settled_at": "2024-01-01T10:05:00.000000Z",
        "created_at": "2024-01-01T10:05:00.000000Z",
        "updated_at": "2024-01-01T10:05:00.000000Z"
      },
      "attachments": [
        {
          "uuid": "990e8400-e29b-41d4-a716-446655440004",
          "url": "https://app.plowf.com/attachments/meds/550e8400-e29b-41d4-a716-446655440000/990e8400-e29b-41d4-a716-446655440004.jpg"
        }
      ],
      "med_type": "RECEIVED_MED",
      "dispute_type": "UNDEFINED",
      "status": "PROCESSING",
      "details": "01",
      "analysis": "Texto de análise do MED",
      "resolved": false,
      "created_at": "2024-01-01T12:00:00.000000Z",
      "updated_at": "2024-01-02T14:30:00.000000Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 5,
    "per_page": 10,
    "to": 10,
    "total": 50
  }
}
Lista todos os MEDs (Mecanismo Especial de Devolução) da conta autenticada com paginação e filtros.
curl -X GET 'https://app.plowf.com/api/v1/meds?status=PROCESSING&per_page=20' \
  -H 'Authorization: Bearer seu_token_aqui'

Parâmetros de Query

Todos os parâmetros são opcionais.
uuid
string
Filtrar por UUID específico do MED
status
string
Status do MED. Valores possíveis:
  • PENDING - Pendente
  • PROCESSING - Em processamento
  • ACCEPTED - Aceito
  • REJECTED - Rejeitado
  • CANCELLED - Cancelado
med_type
string
Tipo do MED. Valores possíveis:
  • RECEIVED_MED - MED recebido
  • REQUESTED_MED - MED enviado
dispute_type
string
Tipo da disputa. Valores possíveis:
  • UNDEFINED - Não definido
  • SCAM - Fraude
  • WRONG_TRANSACTION - Transação incorreta
  • COERCION_CRIME - Crime de coação
  • UNAUTHORIZED_ACCESS - Acesso não autorizado
resolved
boolean
Filtrar por MEDs resolvidos ou não resolvidos
date_from
date
Data inicial para filtro (formato: YYYY-MM-DD)
date_to
date
Data final para filtro (formato: YYYY-MM-DD)
per_page
integer
default:"10"
Número de itens por página (mínimo: 1, máximo: 100)

Resposta de Sucesso

{
  "data": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "pix_in_transaction": {
        "uuid": "660e8400-e29b-41d4-a716-446655440001",
        "initiation": {
          "sender": {
            "name": "João Silva",
            "document": "12345678900",
            "account_number": "12345678",
            "account_agency": "0001",
            "bank": {
              "code": "001",
              "name": "Banco Exemplo",
              "ispb": "00000000"
            },
            "account_type": "PAYMENT"
          },
          "receiver": {
            "name": "Empresa Exemplo LTDA",
            "document": "12345678000199",
            "account_number": "87654321",
            "account_agency": "0001",
            "bank": {
              "code": "002",
              "name": "Banco Recebedor",
              "ispb": "00000001"
            },
            "account_type": "CHECKING"
          },
          "txid": "txid123456789abcdef",
          "value": "150.00",
          "type": "QR_DYNAMIC",
          "pix_key": "770e8400-e29b-41d4-a716-446655440002",
          "additional_info": [
            {
              "name": "ID do pagamento",
              "value": "880e8400-e29b-41d4-a716-446655440003"
            }
          ],
          "status": "COMPLETED",
          "expires_at": "2024-01-02T23:59:59.000000Z",
          "created_at": "2024-01-01T10:00:00.000000Z",
          "updated_at": "2024-01-01T10:05:00.000000Z"
        },
        "value": "150.00",
        "movement_type": "IN",
        "type": "EXTERNAL_TRANSFER",
        "status": "SETTLED",
        "end_to_end": "E00000000202401011000abcdef12345",
        "settled_at": "2024-01-01T10:05:00.000000Z",
        "created_at": "2024-01-01T10:05:00.000000Z",
        "updated_at": "2024-01-01T10:05:00.000000Z"
      },
      "attachments": [
        {
          "uuid": "990e8400-e29b-41d4-a716-446655440004",
          "url": "https://app.plowf.com/attachments/meds/550e8400-e29b-41d4-a716-446655440000/990e8400-e29b-41d4-a716-446655440004.jpg"
        }
      ],
      "med_type": "RECEIVED_MED",
      "dispute_type": "UNDEFINED",
      "status": "PROCESSING",
      "details": "01",
      "analysis": "Texto de análise do MED",
      "resolved": false,
      "created_at": "2024-01-01T12:00:00.000000Z",
      "updated_at": "2024-01-02T14:30:00.000000Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 5,
    "per_page": 10,
    "to": 10,
    "total": 50
  }
}
data
object[]
meta
object
Metadados de paginação

Erros Comuns