These docs are for v1.0. Click to read the latest docs for v4.1.

Exemplos

Cenário 1

Objetivo: Alterar Status de uma transação “Aguardando Pagamento” para “Paga”

567

Chamada: Consultar Status da Transação

URL: https://sandbox.api.pagseguro.com/digital-payments/v1/transactions/{transactionCode}/status
{
    "transaction_code": "5EE77A361F714273B25AE9F52CDAA6F1",
    "status": {
        "id": 1,
        "description": "Aguardando pagamento"
    }
}

Cenário 2:

Objetivo: Alterar Status de uma transação “Paga” para “Disputa”

1600

Chamada: Consultar Status da Transação

https://sandbox.api.pagseguro.com/digital-payments/v1/transactions/{transactionCode}/status
{
    "transaction_code": "5EE77A361F714273B25AE9F52CDAA6F1",
    "status": {
        "id": 3,
        "description": "Paga"
    }
}

**Chamada: Alterar Status da Transação para “Disputa”

URL https://sandbox.api.pagseguro.com/digital-payments/v1/transactions/{transactionCode}/status

Header:
Authorization - Bearer  {token}
Content-Type - application/json
{
	"status_to": "5"
}
{
    "transaction_code": "5EE77A361F714273B25AE9F52CDAA6F1",
    "status": {
        "id": 5,
        "description": "Em disputa"
    }
}
1515

🚧

Consultar em Apêndice o código (id) referente ao status da transação.

Cenário 3:

Objetivo: Tentativa de alteração de status não permitido, de: “Paga” para “Bloqueada”

1512
https://sandbox.api.pagseguro.com/digital-payments/v1/transactions/{transactionCode}/status
{
    "transaction_code": "57BBA86F0D354C46A5D75F4915428EE3",
    "status": {
        "id": 3,
        "description": "Paga"
    }
}
{
	"status_to": "12"
}

{
    "errors": [
        {
            "code": "invalid_transition_between_transaction_status",
            "message": "transaction with status Paga can only be changed to status Devolvida Disponível Em disputa Retenção temporária Processando o estorno",
            "info": "https://api.pagseguro.com.br/errors/invalid_transition_between_transaction_status"
        }
    ]
}

Cenário 4:

Objetivo: Alterar o status de uma transação para “Disponível”.

📘

Pré-requisito:

Definir o valor da configuração como “Em análise” para que a transação inicie com esse status.

Chamada: Consultar Status da Transação

URL:
https://sandbox.api.pagseguro.com/digital-payments/v1/transactions/{transactionCode}/status
{
    "transaction_code": "294E714BE2D74B21821645F218054758",
    "status": {
        "id": 2,
        "description": "Em análise"
    }
}

Chamada: Alterar Status da Transação

url: https://sandbox.api.pagseguro.com/digital-payments/v1/transactions/{transactionCode}/status
Header:
Authorization - Bearer  {token}
Content-Type - application/json
Request
{
    "transaction_code": "294E714BE2D74B21821645F218054758",
    "status": {
        "id": 4,
        "description": "Disponível"
    }
}

🚧

Consultar em Apêndice o código (id) referente ao status da transação.

Cenário 5:

Objetivo: Não informar o transaction_code na chamada de Consultar Status da Transação

URL:
https://sandbox.api.pagseguro.com/digital-payments/v1/transactions/{NÃO INFORMAR VALOR}/status
{
    "timestamp": "2019-07-05T13:51:48.860+0000",
    "status": 404,
    "error": "Not Found",
    "message": "No message available",
    "path": "/transactions/status"
}

Cenário 6:

Objetivo: Informar o transaction_code inválido na chamada de Consultar Status da Transação

URL:
https://sandbox.api.pagseguro.com/digital-payments/v1/transactions/transaction_code_invalido/status
{
    "errors": [
        {
            "code": "unexpected_internal_error",
            "message": "Internal error.",
            "info": "https://api.pagseguro.com.br/errors/unexpected_internal_error"
        }
    ]
}