Method: disburseFundsResultNotification

Notificar a Google el resultado de un desembolso después de realizar la llamada al método disburseFunds

El valor de disburseFundsResult es idempotente para este disburseFundsRequestId, por lo que su valor debe ser idéntico al que se muestra durante la llamada de disburseFunds y no se puede cambiar en una llamada posterior a este método.

Si el extremo encuentra un error mientras se procesa la solicitud, la respuesta de este extremo será del tipo ErrorResponse.

Es posible que las respuestas a esta consulta estén vacías si este método no muestra un HTTP 200. El cuerpo de la respuesta está vacío en los casos en que se pueda usar un elemento ErrorResponse con una descripción clara para ayudar a un atacante a comprender el identificador de la cuenta del integrador de pagos de otros integradores. En estos casos, en los que la clave de firma no coincide, no se encontró el identificador del integrador de pago o la clave de encriptación es desconocida, este método mostrará un HTTP 404 con un cuerpo vacío. Si se pudo verificar la firma de la solicitud, se mostrará información adicional sobre el error en el cuerpo de la respuesta.

Una solicitud de ejemplo se ve de la siguiente manera:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 1,
      "revision": 0
    },
    "requestId": "KcgwSKrV76eVNDUbsZ4UA3",
    "requestTimestamp": "1481852928293"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "disburseFundsRequestId": "awNaC510cefae3IJdNEvW2",
  "disburseFundsResult": {
    "disburseFundsResultCode": "SUCCESS"
  }
}

Una respuesta de ejemplo se ve de la siguiente manera:


{
  "responseHeader": {
    "responseTimestamp": "1481852928324"
  },
  "result": "SUCCESS"
}

Solicitud HTTP

POST https://vgw.googleapis.com/secure-serving/gsp/v1/disburseFundsResultNotification/:PIAID

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "disburseFundsRequestId": string,
  "disburseFundsResult": {
    object (DisburseFundsResult)
  }
}
Campos
requestHeader

object (RequestHeader)

OBLIGATORIO: Es un encabezado común para todas las solicitudes.
paymentIntegratorAccountId

string

OBLIGATORIO: Es el identificador de la cuenta del integrador de pagos en el que se produjo el desembolso.
disburseFundsRequestId

string

OBLIGATORIO: Es un identificador único para esta transacción. Este es el requestId generado por Google durante la llamada a disburseFunds con la que está asociada esta solicitud.

Es una string con una longitud máxima de 100 caracteres y contiene solo los caracteres "a-z", "A-Z", "0-9", ":", "-" y "_".
disburseFundsResult

object (DisburseFundsResult)

OBLIGATORIO: Resultado de esta llamada de desembolso de fondos.

Cuerpo de la respuesta

Objeto de respuesta para el método disburseFundsResultNotification.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": enum (DisburseFundsResultNotificationResultCode)
}
Campos
responseHeader

object (ResponseHeader)

OBLIGATORIO: Es el encabezado común para todas las respuestas.
result

enum (DisburseFundsResultNotificationResultCode)

OBLIGATORIO: Resultado de esta llamada.

DisburseFundsResult

Información sobre el resultado final de un desembolso.

Representación JSON 
{
  "disburseFundsResultCode": enum (DisburseFundsResultCode),
  "rawResult": {
    object (RawResult)
  },

  // Union field FailureDetail can be only one of the following:
  "transactionMaxLimit": string,
  "transactionMinLimit": string
  // End of list of possible types for union field FailureDetail.
}
Campos
disburseFundsResultCode

enum (DisburseFundsResultCode)

OBLIGATORIO: Es el código de resultado de este desembolso.
rawResult

object (RawResult)

OPCIONAL: Resultado bruto de este desembolso. Se usa para ayudar a informar el motor de riesgos y las estadísticas de Google. En situaciones de rechazo del código, es posible que se pierdan datos. El integrador puede optar por darle a Google un código sin procesar. Por ejemplo, una puerta de enlace de tarjetas de crédito (el integrador) puede utilizar este campo para comunicar a Google el código de rechazo exacto que se recibió de la red VISA. En ese caso, el scope sería "visa" y el rawCode sería lo que mostrara la red VISA.

Este valor es obligatorio si result no es SUCCESS.

Campo de unión FailureDetail.

FailureDetail puede ser una de las siguientes opciones:
transactionMaxLimit

string (Int64Value format)

OPCIONAL: Si disburseFundsResultCode es DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT, este es el valor de la transacción máxima permitida. Se usa para los mensajes estructurados y orientados al usuario, y para el análisis del porcentaje de rechazo.

Este importe es de micros del mismo objeto currencyCode que la llamada al método disburseFunds original.
transactionMinLimit

string (Int64Value format)

OPCIONAL: Si disburseFundsResultCode es DISBURSEMENT_UNDER_TRANSACTION_LIMIT, este es el valor de la transacción mínima permitida. Se usa para los mensajes estructurados y orientados al usuario, y para el análisis del porcentaje de rechazo.

Este importe es de micros del mismo objeto currencyCode que la llamada al método disburseFunds original.

Código de resultado de desembolso

Códigos de resultado para una llamada de desembolso de fondos.

Enumeradores
UNKNOWN_RESULT No establezcas este valor predeterminado.
SUCCESS El desembolso se realizó correctamente.
DISBURSEMENT_UNDER_TRANSACTION_LIMIT El importe del desembolso solicitado no cumple con el importe mínimo por transacción del integrador. Si se usa este código, propaga el campo transactionMinLimit con el importe mínimo de transacción para los mensajes del usuario.
DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT El importe del desembolso solicitado supera el límite máximo por transacción del integrador. Si se usa este código, propaga el campo transactionMaxLimit con el límite de transacción para fines de mensajería del usuario.
ACCOUNT_CLOSED Se cerró la cuenta del usuario que tenía el integrador. Este valor de retorno provocará que el instrumento de pago se cierre con Google. El usuario se verá obligado a agregar un instrumento nuevo.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER Se cerró la cuenta del usuario que tiene el integrador y se sospecha que la cuenta tomó el control. Este valor de retorno provocará que el instrumento de pago se cierre con Google. El usuario se verá obligado a agregar un instrumento nuevo.
ACCOUNT_CLOSED_FRAUD Se cerró la cuenta del usuario que tenía el integrador debido a un fraude. Este valor de retorno provocará que el instrumento de pago se cierre con Google. El usuario se verá obligado a agregar un instrumento nuevo.
ACCOUNT_ON_HOLD La cuenta del usuario está suspendida.

Resultado sin procesar

Objeto de resultado sin procesar.

Representación JSON 
{
  "scope": string,
  "rawCode": string
}
Campos
scope

string

OPCIONAL: El alcance del rawCode puede estar vacío.
rawCode

string

OBLIGATORIO: Código sin procesar del integrador o los subsistemas que contiene.

DisburseFundsResultNotificationResultCode.

Códigos de resultado para el método disburseFundsResultNotification

Enumeradores
UNKNOWN_RESULT No establezcas este valor predeterminado.
SUCCESS La notificación se procesó correctamente.