- Solicitação HTTP
- Corpo da solicitação
- Corpo da resposta
- RefundResultCode.
- RefundResultNotificationResultCode.
Notifique o Google sobre o resultado de um reembolso após uma chamada de método refund
ter sido feita.
Reembolsos devem ser tratados de maneira síncrona durante a chamada de método refund
, mas esse método fornece ao Google um sinal de backup rápido caso a chamada síncrona falhe depois de executar a ação, mas antes de retornar um resultado. Isso evita o atraso introduzido pelo Google ao programar uma nova tentativa para um horário futuro.
O valor refundResult
é idempotente para esse refundRequestId
. Portanto, o valor não pode ser alterado por uma chamada subsequente para esse método.
Se o endpoint encontrar um erro ao processar a solicitação, a resposta desse endpoint será do tipo
.ErrorResponse
As respostas a esta consulta podem estar vazias se esse método não retornar um HTTP 200. O corpo da resposta fica vazio em situações em que um
com uma descrição clara pode ser usado para ajudar um invasor a entender o identificador da conta do integrador de pagamentos de outros integradores. Nessas situações, quando a chave de assinatura não corresponde, o identificador do integrador de pagamentos não é encontrado ou a chave de criptografia é desconhecida, esse método retorna um HTTP 404 com um corpo vazio. Se a assinatura da solicitação puder ser verificada, informações adicionais sobre o erro serão retornadas no corpo da resposta.ErrorResponse
Veja abaixo um exemplo de solicitação:
{
"requestHeader": {
"protocolVersion": {
"major": 1,
"minor": 1,
"revision": 0
},
"requestId": "HsKv5pvtQKTtz7rdcw1YqE",
"requestTimestamp": "1481855928301"
},
"paymentIntegratorAccountId": "InvisiCashUSA_USD",
"refundRequestId": "hH1T32PI86CpKwjuf6oD2r",
"paymentIntegratorRefundId": "invisi/Id::xx__1243",
"refundResult": "SUCCESS"
}
Veja um exemplo de resposta:
{
"responseHeader": {
"responseTimestamp": "1481855928376"
},
"result": "SUCCESS"
}
Solicitação HTTP
POST https://vgw.googleapis.com/secure-serving/gsp/v1/refundResultNotification/:PIAID
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
Representação JSON |
---|
{ "requestHeader": { object ( |
Campos | |
---|---|
requestHeader |
OBRIGATÓRIO: cabeçalho comum para todas as solicitações. |
paymentIntegratorAccountId |
OBRIGATÓRIO: identificador da conta do integrador de pagamentos em que o reembolso foi feito. |
refundRequestId |
OBRIGATÓRIO: identificador exclusivo do reembolso, estabelecido pelo campo |
refundResult |
OBRIGATÓRIO: resultado do reembolso. |
paymentIntegratorRefundId |
OBRIGATÓRIO: esse identificador é específico para o integrador e é gerado pelo integrador. Esse é o identificador que o integrador conhece o reembolso. Por conveniência, este identificador está incluído nos detalhes da remessa |
Corpo da resposta
Objeto de resposta para o método refundResultNotification
.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Representação JSON |
---|
{ "responseHeader": { object ( |
Campos | |
---|---|
responseHeader |
OBRIGATÓRIO: cabeçalho comum para todas as respostas. |
result |
OBRIGATÓRIO: resultado da chamada. |
Código do reembolso
O resultado exclusivo codifica os reembolsos.
Enums | |
---|---|
UNKNOWN_RESULT |
Nunca defina esse valor padrão. |
SUCCESS |
Reembolso concluído. |
NO_MONEY_LEFT_ON_TRANSACTION |
Falha no reembolso. Não há fundos restantes na transação. Normalmente, isso representa um bug entre o integrador e o Google. O Google não deve pedir o reembolso de um valor maior que a captura original. |
ACCOUNT_CLOSED |
A conta associada ao integrador foi encerrada. Retornar esse valor fará com que o instrumento do usuário seja fechado com o Google. O usuário será forçado a adicionar um novo instrumento passando pelo fluxo de associação novamente. |
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER |
A conta do usuário com o integrador foi encerrada. A conta pode ter sido invadida. Retornar esse valor fará com que o instrumento do usuário seja fechado com o Google. O usuário será forçado a adicionar um novo instrumento passando pelo fluxo de associação novamente. |
ACCOUNT_CLOSED_FRAUD |
A conta do usuário associada ao integrador foi encerrada por fraude. Retornar esse valor fará com que o instrumento do usuário seja fechado com o Google. O usuário será forçado a adicionar um novo instrumento passando pelo fluxo de associação novamente. |
ACCOUNT_ON_HOLD |
A conta do usuário está retida no momento e não pode aceitar o reembolso, mas a conta do usuário poderá aceitar o reembolso posteriormente. O Google poderá solicitar outro reembolso no futuro, mas fará isso com um novo requestId . Portanto, a solicitação será considerada concluída. |
REFUND_EXCEEDS_MAXIMUM_BALANCE |
O reembolso não pode ser processado no momento porque isso faria com que o saldo do usuário excedesse o valor máximo permitido. O Google poderá solicitar outro reembolso no futuro, mas fará isso com um novo requestId . Portanto, a solicitação será considerada concluída. |
REFUND_WINDOW_EXCEEDED |
O reembolso não pode ser processado porque a solicitação está fora do período de reembolso permitido. |
ReembolsoResultNotificationNotificationResultCode
Códigos de resultado para o método refundResultNotification
.
Enums | |
---|---|
UNKNOWN_RESULT |
Nunca defina esse valor padrão. |
SUCCESS |
A notificação do resultado do reembolso foi enviada. |