Compra un plan

POST/api/v1/account/billing/checkout

Cobra el plan con la tarjeta guardada o con la que llega (que queda guardada). El plan se abre cuando Wompi aprueba el pago y su año cuenta desde ese día; si ya había un plan activo, lo reemplaza (sus documentos libres no se acumulan). 201 si se aprobó de inmediato; 202 si sigue en proceso: consultar GET /account/billing/charges/{id} hasta un estado final. Un pago a la vez (409 error.billing.charge_in_progress).

Cuerpo de la petición application/json

card_tokenstring
Ejemplo: tok_test_12345_abc
acceptance_tokenstring
accept_personal_authstring
plan_idstringobligatorio
Ejemplo: empresa-10

Respuestas

201Pago aprobado y plan activo

idstring · uuid
plan_idstring
plan_namestring
amount_copinteger
Ejemplo: 525000
reasonstring
purchase: compra desde el panel; renewal: recompra al agotarse o vencer
Valores: purchase · renewal
statusstring
Valores: pending · processing · approved · declined · error
status_messagestring
account_plan_idstring · uuid
Plan abierto con este pago
created_atstring · date-time
finished_atstring · date-time

202Pago en proceso

idstring · uuid
plan_idstring
plan_namestring
amount_copinteger
Ejemplo: 525000
reasonstring
purchase: compra desde el panel; renewal: recompra al agotarse o vencer
Valores: purchase · renewal
statusstring
Valores: pending · processing · approved · declined · error
status_messagestring
account_plan_idstring · uuid
Plan abierto con este pago
created_atstring · date-time
finished_atstring · date-time

400Datos inválidos (details trae los campos)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring

401Falta la key o es inválida, está deshabilitada, vencida o revocada (error.missing_api_key, error.invalid_api_key, error.api_key.disabled, error.api_key.expired, error.api_key.revoked)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring

404No existe (o es de otra cuenta)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring

409Conflicto con el estado actual (p. ej. documento referenciado no aceptado, rango agotado)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring