Pagos
Actualizado:
Cada punto final de pago utiliza el mismo ciclo de dos solicitudes del protocolo x402: la primera solicitud devuelve el precio y la segunda lo abona.
El proceso
Solicitar presupuesto
POST /orders(o/renew,/traffic,/topup) sin encabezados de pagoResultados
402 Payment Required: el presupuesto en el cuerpo del texto y los requisitos de pago en elPAYMENT-REQUIREDencabezado. No se reserva ni se cobra nada.Firma la autorización
EIP-3009 transferWithAuthorizationFirma una transferencia de USDC por un importe exacto de
amountapayTocon tu monedero. Una firma por sí sola no transfiere fondos.Repite la solicitud con la firma
Mismo método, ruta y cuerpo, además de
PAYMENT-SIGNATUREResultados
202 Acceptedcon el ID de la operación, su estado y, en el caso de nuevos pedidos y recargas, un token de acceso. ElPAYMENT-RESPONSEEl encabezado contiene la transacción.Votar el resultado
GET /orders/{id}oGET /topup/{id}El pago se confirma primero en la red y, a continuación, se lleva a cabo la operación. Realiza una consulta cada
next_poll_after_secondshastastatus_is_terminalestrue.
Antes de empezar
Cartera con USDC en Base: el pagador. No se necesita ETH para el gas.
Cliente x402: cualquier cliente con la versión 2 de x402, el
exactScheme y EIP-3009, o tu propio código (Encabezados de pago).Términos actuales: las versiones de
catalog.termsentrar enaccept_termsde un nuevo pedido.
Común a todos los puntos finales de pago
URL base
https://proxy-seller.com/api/x402/v1Protocolo de pago
x402 versión 2, esquema exact, método de transferencia EIP-3009, flujo upfront: se paga antes de que se complete el pedido. El encabezado de la versión 1 X-PAYMENT se rechaza.
Cita
Una cita dura 15 minutos (quote_expires_at). La solicitud de pago debe repetir el cuerpo de la solicitud gratuita; solo idempotency_key, callback_url y auto_renew pueden variar.
Modelo de errores
Códigos de estado HTTP reales y un cuerpo JSON con retry_action que indica qué hacer a continuación (Errores).
Puntos finales de pago
Punto final | Lo que pagas | Quién puede pagar |
|---|---|---|
| Un nuevo encargo | Cualquier monedero; este pasa a ser el titular del pedido |
| Renovación de una línea de pedido | Solo la cartera que pagó el pedido |
| Tráfico residencial | Solo la cartera que pagó el pedido |
| Recarga de saldo para la renovación automática | Cualquier monedero; el saldo de este monedero se abona |
Cuánto tiempo lleva
Después del 202 Una vez que se confirme el pago en la red Base, se completará el pedido. Los proxies suelen estar listos en pocos minutos. Los proxies móviles los emite manualmente nuestro personal: el plazo puede ser de hasta 3 horas.
Una operación de pago nunca se pierde. Si falla un paso, la operación queda en espera hasta que nuestro personal la resuelva, y no se cobra el importe dos veces.
Una vez que hayas pagado
Preguntas frecuentes
No. La autorización firmada se envía a la red en tu nombre.
Solicita un nuevo presupuesto. Si ya has enviado una solicitud firmada con un presupuesto caducado, la respuesta te indicará qué debes hacer: 402 quote_expired incluye una nueva cita directamente en la respuesta; 409 payment_not_settleable significa que tu autorización anterior aún puede ejecutarse, así que espera hasta que authorization_expires_at antes de firmar uno nuevo.
No. Una autorización solo puede ejecutarse una vez en la red, y repetir la misma PAYMENT-SIGNATURE devuelve el resultado del primer intento. No firmes una nueva autorización mientras la anterior aún pueda ejecutarse: las respuestas de error indican hasta cuándo (authorization_expires_at).
Repite la misma solicitud con el mismo PAYMENT-SIGNATURE. Es seguro: obtienes el resultado del primer intento.
No a través de la API. Ponte en contacto con [email protected] con el número de pedido.
Si existe, su dirección se publica en el catálogo como protocol.sandbox_url.