Simular pagamento Pagar com PagBank (Deeplink )

Este endpoint possibilita a simulação de pagamento do deeplink, de acordo com os métodos de pagamento que o pagador queira utilizar (saldo ou cartão de crédito). Será possível simular o pagamento com sucesso e negado.

Para simular o pagamento é necessário possuir o id-deeplink, representado pelo parametro r contido no Deeplink. Observando o caso abaixo por exemplo, o id-deeplink é igual a "11111111-2222-3333-4444-555555555555".

// demais campos retornados no serviço do Order omitidos por motivos de simplificação
 
"deep_links": [
    {
        "url": "https://pagseguro.uol.com.br/para-seu-negocio/aplicativos/minha-conta/download?f=order&r=11111111-2222-3333-4444-555555555555",
        "amount": {
            "value": 101
        }
    }
]

📘

Valor da simulação

No ambiente de simulação, os pedidos deverão ter valor entre R$ 1,00 e R$ 1.500,00

Simulando um pagamento com Saldo da Conta
Para simular o pagamento com Saldo da Conta, basta realizar a chamada abaixo onde o parametro status-desejado deve ser:

  • PAID - para simular um pagamento com sucesso;
  • DECLINED - para simular um pagamento rejeitado.
curl --location --request POST 'https://sandbox.sdk.pagseguro.com/pagpay/balance/{id-deeplink}' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "status":"{status-desejado}"
}'
"PAID"
"DECLINED"

Simulando um pagamento com Cartão de Crédito
Para simular o pagamento com Cartão de crédito, basta realizar a chamada abaixo, onde o parametro cartão-desejado deve ser de acordo com a tabela a seguir:

Número do cartãoBandeiraStatus esperado da transação
4111111111111111VISAPAID
4242424242424242VISADECLINED
5454555555555555MASTERCARDPAID
5454545454545454MASTERCARDDECLINED
378282246310005AMERICAN EXPRESSPAID
34343434343434AMERICAN EXPRESSPAID
3841001111222233334HIPERPAID
6550000000000001ELOPAID
curl --location --request POST 'https://sandbox.sdk.pagseguro.com/pagpay/credit-card/{id-requisicao}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "card_number": "{cartao_desejado}"
}'
"PAID"
"DECLINED"

Tratamento de erros simulação de pagamento
Em caso de falhas no envio da requisição ou no processamento da mesma, é possível receber um código de erro 4XX ou 5XX com o seguinte payload:

{
    "errors": [
        {
            "code": "<Código de erro>",
            "message": "<Mensagem do erro>"
        }
    ]
}

Abaixo a tabela de possíveis erros retornados:

Status HttpCódigo de ErroMensagem do erro
40040003Bad Request
40040005Invalid status payment confirmation
40040006Invalid status mock payment
40040007Invalid credit card number
40440401Object not found
40940901Payment has already been processed
41041001Deeplink is no longer accessible
50050001Unexpected error
50050002Integration error
50450401Payment confirm timeout

Links Relacionados: