Method: purchases.subscriptions.acknowledge

Procesa la compra de una suscripción.

Solicitud HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:acknowledge

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
packageName

string

Es el nombre del paquete de la aplicación para la que se compró la suscripción (por ejemplo, "com.algo.algo").
subscriptionId

string

Nota: Desde el 21 de mayo de 2025, no se requiere subscriptionId y no se recomienda para suscripciones con complementos. Es el ID de la suscripción que se compró (por ejemplo, "mensual001").
token

string

Es el token que se proporcionó al dispositivo del usuario cuando se compró la suscripción.

Cuerpo de la solicitud

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

Representación JSON 
{
  "developerPayload": string,
  "externalAccountIds": {
    object (ExternalAccountIds)
  }
}
Campos
developerPayload

string

Es la carga útil que se adjuntará a la compra.
externalAccountIds

object (ExternalAccountIds)

Opcional. Es el identificador de la cuenta de usuario en tu app.

Cuerpo de la respuesta

Si se ejecuta correctamente, el cuerpo de la respuesta está vacío.

Muestra

A continuación, se muestra una solicitud de ejemplo:

curl -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptions/monthly_premium_001/tokens/abcDEF123ghiJKL456mnoPQR789:acknowledge' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "developerPayload": "AppSpecificInfo-UserID-12345"
  }'

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/androidpublisher

ExternalAccountIds

Es el identificador de la cuenta de usuario en tu app.

Representación JSON 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string
}
Campos
obfuscatedAccountId

string

Opcional. Especifica una cadena ofuscada opcional que se asocia de forma única con la cuenta de usuario del comprador en tu app.

Si pasas este valor, Google Play puede usarlo para detectar actividad irregular. No uses este campo para almacenar información de identificación personal (IIP), como correos electrónicos en texto no cifrado. Si se intenta almacenar PII en este campo, se bloquearán las compras. Google Play recomienda que uses el cifrado o un hash unidireccional para generar un identificador ofuscado que se envíe a Google Play.

Este identificador tiene un límite de 64 caracteres.

Este campo solo se puede configurar para compras de renovación de suscripciones. Consulta https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid para configurar este campo para las compras realizadas con el flujo de facturación integrada estándar.
obfuscatedProfileId

string

Opcional. Especifica una cadena ofuscada opcional que se asocia de forma única con el perfil de usuario del comprador en tu app.

Si pasas este valor, Google Play puede usarlo para detectar actividad irregular. No uses este campo para almacenar información de identificación personal (IIP), como correos electrónicos en texto no cifrado. Si se intenta almacenar PII en este campo, se bloquearán las compras. Google Play recomienda que uses el cifrado o un hash unidireccional para generar un identificador ofuscado que se envíe a Google Play.

Este identificador tiene un límite de 64 caracteres.

Este campo solo se puede configurar para compras de renovación de suscripciones. Consulta https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid para configurar este campo para las compras realizadas con el flujo de facturación integrada estándar.