Saltar al contenido principal
PUT
Update payment

📌 Endpoint

PUT /stores/{storeId}/payments/{paymentId} Actualiza el envío (shipment) y/o la metadata de un pago aprobado.

🔐 Autenticación

  • Ruta privada.
  • Requiere header Authorization con tu API key y plan activo.

🧾 Parámetros de ruta


🧍 Body (JSON)


✅ Ejemplo de solicitud


Snippet estándar (cURL)

Usa el ejemplo cURL de la sección Ejemplo de solicitud anterior como snippet oficial.

📦 Respuesta de éxito (200)


⚠️ Posibles errores

  • 400 INVALID_DATA → body/parámetros inválidos
  • 401 API_KEY_NOT_PROVIDED → header Authorization no enviado
  • 401 INVALID_API_KEY → API key inválida
  • 401 UNAUTHENTICATED → usuario no autenticado
  • 403 USER_DISABLED → usuario desactivado o eliminado
  • 403 NO_ACTIVE_SUBSCRIPTION → plan inactivo o expirado
  • 403 UPDATE_NOT_ALLOWED → el pago no está aprobado
  • 404 STORE_NOT_FOUND → tienda no encontrada
  • 404 PAYMENT_NOT_FOUND → pago no encontrado
  • 429 RATE_LIMIT_EXCEEDED → límite de solicitudes por minuto del plan excedido
  • 500 INTERNAL_SERVER_ERROR → error interno
  • 503 SERVICE_UNAVAILABLE → servicio temporalmente no disponible

Autorizaciones

Authorization
string
header
predeterminado:YOUR_API_KEY_HERE
requerido

Parámetros de ruta

storeId
string
requerido
Required string length: 1 - 50
paymentId
string
requerido
Required string length: 1 - 50

Cuerpo

application/json

Payment fields to update.

shipment
enum<string>
Opciones disponibles:
PENDING,
PREPARING,
SHIPPED,
DELIVERED,
RETURNED,
CANCELLED
metadata
object

Respuesta

Update payment.

code
string
requerido
Ejemplo:

"PAYMENT_UPDATED"

payment
object
requerido

Store payment/charge.