Reembolso
Saiba mais sobre como você pode realizar o gerenciamento de pedidos de reembolso para os seus consumidores através do uso da API da Preme Pay.
Para pagamentos realizados via Cartão de Crédito, é possível realizar estornos parciais ou totais. Os fundos serão estornados ​​no cartão de crédito originalmente cobrado.
Precisa realizar um estorno total? No caso de estorno do valor total da transação, a ordem de pagamento terá seu status alterado para Cancelada.

Criar Reembolso

https://api.premepay.com/v1/stores/{storeId}/payments/{paymentId}/refunds
Você pode criar um reembolso total ou parcial para todas as transações pagas com Cartão de Crédito utilizando a rota acima.
Parâmetro
Tipo
Descrição
Obrigatório
amount
decimal
Valor total a ser estornado
Sim

Exemplo de Requisição para Criar Reembolso

Este é um exemplo de como a sua requisição para Criar Reembolso para seu consumidor deve parecer. É assim que você pode efetuar estornos diretamente para o cartão do seu consumidor utilizado no momento da compra.
{
"amount": 150.50
}

Respostas

200: Created

400: Bad Request

Esta é a resposta para os casos em que o servidor não processa a requisição devido a um erro encontrado. Alguns exemplos que podem resultar neste erro são uma URL digitada incorretamente, sintaxe malformada ou requisição de roteamento inválida.
{
"errors": [
{
"message": "Error description"
}
],
"status": 400,
"detail": "Error details"
}

401: Unauthorized

Esta é a resposta para os casos em que a solicitação não foi bem sucedida porque não possui credenciais de autenticação válidas para o recurso de destino. Caso seja necessário, você pode rever o nosso processo de autenticação.
{
"error": {
"message": "Unauthorized"
}
}

403: Forbidden

Esta é a resposta para os casos em que a solicitação foi proibida. Isso acontece quando o servidor consegue entender o pedido da requisição, mas não autoriza a emissão de uma resposta de aprovação.
{
"status": 403
}

500: Internal Server Error

Esta é a resposta para os casos em que ocorre um erro interno no servidor.
{
"status": 500,
"detail": "Error details"
}

Listar Reembolso

https://api.premepay.com/v1/stores/{storeId}/payments/{paymentId}/refunds
Você pode visualizar a lista de reembolsos que já realizou utilizando a rota acima.

Respostas

200: Ok

Esta é a resposta para os casos em que sua requisição seja bem sucedida.
[
{
"amount": 150.50,
"createdOn": "2020-07-20T21:54:52.405Z"
}
]

401: Unauthorized

Esta é a resposta para os casos em que a solicitação não foi bem sucedida porque não possui credenciais de autenticação válidas para o recurso de destino. Caso seja necessário, você pode rever o nosso processo de autenticação.
{
"error": {
"message": "Unauthorized"
}
}

403: Forbidden

Esta é a resposta para os casos em que a solicitação foi proibida. Isso acontece quando o servidor consegue entender o pedido da requisição, mas não autoriza a emissão de uma resposta de aprovação.
{
"error": {
"message": "Forbidden"
}
}

404: Not found

Esta é a resposta para os casos em que seu usuário não foi encontrado. Este é um código de resposta HTTP que indica que houve comunicação entre a requisição e o servidor, entretanto o servidor não conseguiu encontrar o que foi requerido.
{
"error": {
"message": "User not found"
}
}

500: Internal Server Error

Esta é a resposta para os casos em que ocorre um erro interno no servidor.
{
"error": {
"message": "Internal server error"
}
}

Detalhamento de Reembolso

https://api.premepay.com/v1/stores/{storeId}/payments/{paymentNumber}/refunds/{refundId}
Com a API da Preme Pay e a rota acima você pode visualizar os detalhes de um reembolso criado com sucesso.

Respostas

200: Ok

Esta é a resposta para os casos em que sua requisição seja bem sucedida.
{
"amount": 150.50,
"createdOn": "2020-07-20T21:59:54.325Z"
}

401: Unauthorized

Esta é a resposta para os casos em que a solicitação não foi bem sucedida porque não possui credenciais de autenticação válidas para o recurso de destino. Caso seja necessário, você pode rever o nosso processo de autenticação.
{
"error": {
"message": "Unauthorized"
}
}

403: Forbidden

Esta é a resposta para os casos em que a solicitação foi proibida. Isso acontece quando o servidor consegue entender o pedido da requisição, mas não autoriza a emissão de uma resposta de aprovação.
{
"error": {
"message": "Forbidden"
}
}

404: Not found

Esta é a resposta para os casos em que seu usuário não foi encontrado. Este é um código de resposta HTTP que indica que houve comunicação entre a requisição e o servidor, entretanto o servidor não conseguiu encontrar o que foi requerido.
{
"error": {
"message": "User not found"
}
}

500: Internal Server Error

Esta é a resposta para os casos em que ocorre um erro interno no servidor.
{
"error": {
"message": "Internal server error"
}
}
Copy link
Outline
Criar Reembolso
Listar Reembolso
Detalhamento de Reembolso