Saltar al contenido principal

Buscar intenciones de pago

Mediante el lenguaje de consultas de búsqueda de Stripe, puedes buscar «Payment Intents» creados anteriormente.

Evita las consultas de búsqueda en los flujos de trabajo de «lectura tras escritura» que requieran consistencia inmediata de los datos. En condiciones normales de funcionamiento, los datos están disponibles para su búsqueda durante menos de un minuto. Ocasionalmente, durante las interrupciones del servicio, la propagación de datos nuevos o actualizados puede sufrir un retraso de hasta una hora.

nota

La función de búsqueda no está disponible para los comerciantes de la India.

GET https://api.stripe.com/v1/payment_intents/search

Ejemplos​

Ejemplo de cURL:

cURL
curl -X GET "https://api.stripe.com/v1/payment_intents/search?query=amount:1000" \
  -u <YOUR_SECRET_KEY>:

Respuestas​

Las respuestas devuelven códigos estándar.

200: OK

Response
{
  "object": "search_result",
  "data": [],
  "has_more": false,
  "url": "/v1/payment_intents/search"
}

Respuestas de error​

400: Bad Request

Response
{
  "error": {
    "code": "parameter_invalid_string",
    "doc_url": "https://stripe.com/docs/error-codes/parameter-invalid-string",
    "message": "Provide a query parameter with a valid search query string.",
    "param": "query",
    "type": "invalid_request_error"
  }
}

401: Unauthorized

Response
{
  "error": {
    "type": "invalid_request_error",
    "message": "Invalid API Key provided: sk_test_********************1234"
  }
}

Parámetros​

Parámetros de consulta​
ParámetroTipoDescripción
expand[]matriz de cadenasIdentifica objetos de respuesta anidados para enriquecerlos y devolverlos en línea.
limitenteroLimita el número de registros en la respuesta. Introduce un número entero entre 1 y 100 (valor por defecto: 10).
pagecadenaUn cursor para la paginación a través de varias páginas de resultados. No incluyas este parámetro en la primera llamada. Utiliza el valor de next_page devuelto en una respuesta anterior para solicitar los resultados siguientes.
querycadena(Obligatorio) La cadena de consulta de búsqueda. Consulta el lenguaje de consultas de búsqueda y la lista de campos de consulta compatibles con las intenciones de pago.