Saltar al contenido

API Reference (1.0)

El API de ZRU utiliza métodos HTTP y una estructura RESTful de endpoint.

  • La autenticación del API se realiza vía Header Authorization.
  • Todas las peticiones se deben realizar en formato JSON, y las respuestas del API son en dicho formato.
Descargar descripción de OpenAPI
Resumen
Idiomas
Servidores
v1

https://api.zrupay.com/v1/

Operaciones
Operaciones
Operaciones
Operaciones
Operaciones
Operaciones

Solicitud

Devuelve todos los planes creados en el entorno.

Seguridad
AppKeys
curl -i -X GET \
  https://api.zrupay.com/v1/plan/ \
  -H 'Authorization: YOUR_API_KEY_HERE'

Respuestas

OK

Cuerpoapplication/json
countnumber

Cantidad de elementos

items_per_pagenumber

Cantidad de elementos por página

nextstring or null

URL a próxima página

previousstring or null

URL a página anterior

resultsArray of objects(plan.v1)
Respuesta
application/json
{ "count": 0, "items_per_page": 0, "next": "string", "previous": "string", "results": [ {} ] }

Solicitud

Crea un plan en el entorno.

Seguridad
AppKeys
Cuerpoapplication/json
plan_idstring

Identificador externo

namestringrequerido

Nombre

pricenumber(float)requerido

Precio

descriptionstring

Descripción

durationintegerrequerido

Duración

unitstringrequerido

Unidad de tiempo de la duración (opciones: D - Día, M - Mes, Y - Año)

Enumeración"D""M""Y"
recurringboolean

Si es un plan recurrente o no (por defecto: True)

curl -i -X POST \
  https://api.zrupay.com/v1/plan/ \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "NAME",
    "price": 20,
    "duration": 2,
    "unit": "M",
    "plan_id": "MERCHANT_PLAN_ID",
    "description": "DESCRIPTION",
    "total_payments": 2,
    "extra": {
      "MERCHANT_KEY": "MERCHANT_VALUE"
    }
  }'

Respuestas

OK

Cuerpoapplication/json
idstring(uuid)

Identificador único

display_unitstring

Unidad de tiempo para mostrar

plan_idstring

Identificador externo

namestringrequerido

Nombre

pricenumber(float)requerido

Precio

descriptionstring

Descripción

durationintegerrequerido

Duración

unitstringrequerido

Unidad de tiempo de la duración (opciones: D - Día, M - Mes, Y - Año)

Enumeración"D""M""Y"
recurringboolean

Si es un plan recurrente o no (por defecto: True)

Respuesta
application/json
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "display_unit": "string", "plan_id": "string", "name": "string", "price": 0.1, "description": "string", "duration": 0, "unit": "D", "recurring": true }

Solicitud

Devuelve el plan solicitado.

Seguridad
AppKeys
Ruta
plan-idstring(uuid)requerido

Identificador del plan que se desea solicitar

curl -i -X GET \
  'https://api.zrupay.com/v1/plan/{plan-id}/' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Respuestas

OK

Cuerpoapplication/json
idstring(uuid)

Identificador único

display_unitstring

Unidad de tiempo para mostrar

plan_idstring

Identificador externo

namestringrequerido

Nombre

pricenumber(float)requerido

Precio

descriptionstring

Descripción

durationintegerrequerido

Duración

unitstringrequerido

Unidad de tiempo de la duración (opciones: D - Día, M - Mes, Y - Año)

Enumeración"D""M""Y"
recurringboolean

Si es un plan recurrente o no (por defecto: True)

Respuesta
application/json
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "display_unit": "string", "plan_id": "string", "name": "string", "price": 0.1, "description": "string", "duration": 0, "unit": "D", "recurring": true }

Solicitud

Edita el plan solicitado.

Seguridad
AppKeys
Ruta
plan-idstring(uuid)requerido

Identificador del plan que se desea solicitar

Cuerpoapplication/json
plan_idstring

Identificador externo

namestring

Nombre

pricenumber(float)

Precio

descriptionstring

Descripción

durationinteger

Duración

unitstring

Unidad de tiempo de la duración (opciones: D - Día, M - Mes, Y - Año)

Enumeración"D""M""Y"
recurringboolean

Si es un plan recurrente o no (por defecto: True)

curl -i -X PATCH \
  'https://api.zrupay.com/v1/plan/{plan-id}/' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "price": 150
  }'

Respuestas

OK

Cuerpoapplication/json
idstring(uuid)

Identificador único

display_unitstring

Unidad de tiempo para mostrar

plan_idstring

Identificador externo

namestringrequerido

Nombre

pricenumber(float)requerido

Precio

descriptionstring

Descripción

durationintegerrequerido

Duración

unitstringrequerido

Unidad de tiempo de la duración (opciones: D - Día, M - Mes, Y - Año)

Enumeración"D""M""Y"
recurringboolean

Si es un plan recurrente o no (por defecto: True)

Respuesta
application/json
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "display_unit": "string", "plan_id": "string", "name": "string", "price": 0.1, "description": "string", "duration": 0, "unit": "D", "recurring": true }

Solicitud

Elimina el plan solicitado.

Seguridad
AppKeys
Ruta
plan-idstring(uuid)requerido

Identificador del plan que se desea solicitar

curl -i -X DELETE \
  'https://api.zrupay.com/v1/plan/{plan-id}/' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Respuestas

OK

Operaciones
Operaciones
Operaciones
Operaciones
Operaciones
Operaciones
Operaciones
Operaciones