---
title: "Machine Payments Protocol (MPP)"
description: "Realiza solicitudes pay-per-use de TwexAPI con HTTP 402, Tempo USDC y recibos de pago."
---

# Machine Payments Protocol (MPP)

TwexAPI soporta el [Machine Payments Protocol (MPP)](https://mpp.dev) para solicitudes pay-per-use seleccionadas. Un cliente MPP puede pagar una solicitud elegible con Tempo USDC en lugar de enviar una API key de TwexAPI.

MPP es útil para agentes, scripts y servicios que necesitan pagar solo por las solicitudes que hacen. No reemplaza la autenticación con API key en endpoints que no están listados abajo.

## Operación soportada

| Operación | Qué hace | Método de pago | Precio |
| --- | --- | --- | --- |
| `POST /twitter/advanced_search/page` | Devuelve una página basada en cursor de resultados avanzados de búsqueda de Twitter. | Tempo USDC | USD 0.0001 por página |

El servidor sigue siendo la autoridad para la oferta de pago actual. Lee el desafío `WWW-Authenticate: Payment` devuelto para una solicitud en lugar de codificar en duro un monto, destinatario o formato de credencial de pago.

## Cómo funciona el pago

1. Envía una solicitud normal a un endpoint habilitado para MPP sin API key.
2. El servidor responde con `402 Payment Required` y un desafío `WWW-Authenticate: Payment`.
3. Tu cliente MPP paga la solicitud Tempo USDC descrita por ese desafío y reintenta con una credencial `Authorization: Payment`.
4. Una respuesta liquidada incluye un header `Payment-Receipt`. Verifica tanto el estado HTTP como el cuerpo de respuesta; un recibo solo confirma que el pago fue liquidado.

### Desafío de pago

```http
HTTP/2 402 Payment Required
WWW-Authenticate: Payment id="abc...", realm="api.twexapi.io", method="tempo", intent="charge", request="eyJhbW91bnQiOi..."
```

El valor `request` del desafío contiene la instrucción de pago actual. Trátalo como datos opacos para el cliente MPP; no analices ni construyas un pago desde un ejemplo en caché.

### Reintento pagado y recibo

```http
POST /twitter/advanced_search/page HTTP/2
Host: api.twexapi.io
Authorization: Payment eyJjaGFsbGVuZ2UiOnsi...
Content-Type: application/json

{"searchTerms":["openai"],"sortBy":"Latest"}
```

```http
HTTP/2 200 OK
Payment-Receipt: eyJzdGF0dXMiOiJzdWNjZXNzIiwi...
Content-Type: application/json
```

## MPP y API keys

| Elige | Cuándo encaja |
| --- | --- |
| MPP | Necesitas una solicitud anónima pay-per-use a una operación soportada. |
| API key | Necesitas acceso a la superficie completa de TwexAPI, créditos a nivel de cuenta o endpoints que no publican una oferta MPP. |

Los pagos MPP usan una wallet Tempo financiada con USDC. Mantén la clave privada de la wallet en una variable de entorno y nunca la hagas commit en control de código fuente, logs o transcripciones de chat.

## Próximos pasos

- [MPP quickstart](/mpp/quickstart) — instala el cliente, configura una wallet Tempo y realiza una solicitud de búsqueda pagada.
- [API overview](/api-reference/overview) — usa autenticación con API key y explora el catálogo más amplio de endpoints de TwexAPI.