Suscripciones con wallet

8min
El módulo de suscripciones permite guardar y vincular las tarjetas a nivel suscriptor mediante la funcionalidad "Wallet".
De esta forma, al crear diferentes suscriptores con el mismo valor de referencia "customerReference", es posible seleccionar y modificar las tarjetas compartidas entre los mismos.
Ejemplo: Creación de Suscripción con Wallet
Cuando se crea una suscripción con Wallet se debe enviar el parámetro adicional walleten "true":
JSON
{
  "total": 1000,
  "currency": "ARS",
  "name": "Suscripción con wallet",
  "description": "Mobbex.dev",
  "interval": "1m",
  "trial": 0,
  "reference": "subscription_A00111223",
  "type": "manual",
  "test": true,
  "return_url": " https://mobbex.com",
  "webhook": "https://webhook.com",
  "wallet": true
 }

{
  "total": 1000,
  "currency": "ARS",
  "name": "Suscripción con wallet",
  "description": "Mobbex.dev",
  "interval": "1m",
  "trial": 0,
  "reference": "subscription_A00111223",
  "type": "manual",
  "test": true,
  "return_url": " https://mobbex.com",
  "webhook": "https://webhook.com",
  "wallet": true
 }
﻿
Respuesta
JSON
{
    "result": true,
    "data": {
        "uid": "H4QAGHOPE9QW6CUKVO",
        "name": "Suscripción con wallet",
        "description": "Mobbex.dev",
        "interval": "1m",
        "initialDay": -1,
        "total": 1000,
        "trial": 0,
        "setupFee": 0,
        "charge": "total",
        "ccCutoffDay": -1,
        "url": "https://mobbex.com/p/subscriptions/subscribe/H4QAGHOPE9QW6CUKVO",
        "return_url": " https://mobbex.com",
        "webhook": "https://webhook.com",
        "shorten_url": "https://mobbex.com/p/subscriptions/subscribe/H4QAGHOPE9QW6CUKVO",
        "test": true
    }
}
{
    "result": true,
    "data": {
        "uid": "H4QAGHOPE9QW6CUKVO",
        "name": "Suscripción con wallet",
        "description": "Mobbex.dev",
        "interval": "1m",
        "initialDay": -1,
        "total": 1000,
        "trial": 0,
        "setupFee": 0,
        "charge": "total",
        "ccCutoffDay": -1,
        "url": "https://mobbex.com/p/subscriptions/subscribe/H4QAGHOPE9QW6CUKVO",
        "return_url": " https://mobbex.com",
        "webhook": "https://webhook.com",
        "shorten_url": "https://mobbex.com/p/subscriptions/subscribe/H4QAGHOPE9QW6CUKVO",
        "test": true
    }
}
﻿
Ejemplo: Crear Suscriptor con Wallet
Llamando a la API de crear suscriptor, se debe agregar el parámetro "customerReference" válido que será la referencia del cliente en la wallet.
Múltiples Suscriptores podrán hacer referencia al mismo Customer en la Wallet.
JSON
{
    "customer":{
        "email":"[email protected]",
        "identification":"12123123",
        "name":"Test Mobbex"
    },
    "reference": "R2332112121234",
    "customerReference": "CR2332112121234",
        "startDate":{
        "day": 4,
        "month": 2
    }
  }
{
    "customer":{
        "email":"demo@mobbex.com",
        "identification":"12123123",
        "name":"Test Mobbex"
    },
    "reference": "R2332112121234",
    "customerReference": "CR2332112121234",
        "startDate":{
        "day": 4,
        "month": 2
    }
  }
﻿
Respuesta
JSON
{
    "result": true,
    "data": {
        "uid": "4QRF2DC5L8YUPIYQGY",
        "reference": "R2332112121234",
        "sourceUrl": "https://mobbex.com/p/subscriptions/H4QAGHOPE9QW6CUKVO/subscriber/4QRF2DC5L8YUPIYQGY/source",
        "secondarySourceUrl": "https://mobbex.com/p/subscriptions/H4QAGHOPE9QW6CUKVO/subscriber/4QRF2DC5L8YUPIYQGY/source/secondary",
        "subscriberUrl": "https://mobbex.com/p/subscriptions/H4QAGHOPE9QW6CUKVO/subscriber/4QRF2DC5L8YUPIYQGY",
        "subscription": {
            "uid": "H4QAGHOPE9QW6CUKVO"
        }
    }
}
{
    "result": true,
    "data": {
        "uid": "4QRF2DC5L8YUPIYQGY",
        "reference": "R2332112121234",
        "sourceUrl": "https://mobbex.com/p/subscriptions/H4QAGHOPE9QW6CUKVO/subscriber/4QRF2DC5L8YUPIYQGY/source",
        "secondarySourceUrl": "https://mobbex.com/p/subscriptions/H4QAGHOPE9QW6CUKVO/subscriber/4QRF2DC5L8YUPIYQGY/source/secondary",
        "subscriberUrl": "https://mobbex.com/p/subscriptions/H4QAGHOPE9QW6CUKVO/subscriber/4QRF2DC5L8YUPIYQGY",
        "subscription": {
            "uid": "H4QAGHOPE9QW6CUKVO"
        }
    }
}
﻿
Obtener información con Wallet
Permite obtener la información de los suscriptores creados con sus tarjetas vinculadas (wallet) mediante la referencia "customerReference".
GET
Request
Query Parameters
REF:
String
required
Referencia del suscriptor configurada en "customerReference"
Header Parameters
x-api-key
String
required
Clave API de su aplicación.
x-access-token
String
required
Token de Acceso a la entidad para la cual desea realizar la operación.
﻿
Ejemplo Obtener información con Wallet
GET https://api.mobbex.com/p/wallet/REF:CR2332112121234
Respuesta
JSON
{
    "result": true,
    "data": {
        "uid": "4MR1URZ4D8FILOMNPU",
        "reference": "CR2332112121234",
        "test": true,
        "customerData": {
            "email": "[email protected]",
            "identification": "12123123",
            "name": "Test Demo"
        },
        "features": [],
        "status": "active",
        "sources": [
            {
                "uid": "W:T3J9TBMJFLVKU846WE",
                "name": "Tarjeta terminada en 6691",
                "type": "card",
                "priority": "primary",
                "card": {
                    "number": "47654068****6691",
                    "bin": "47654068",
                    "last4": "6691"
                }
            },
            {
                "uid": "W:36IXF2D0GYABJJYKXP",
                "name": "Tarjeta terminada en 1008",
                "type": "card",
                "priority": "secondary",
                "card": {
                    "number": "53236299****1008",
                    "bin": "53236299",
                    "last4": "1008"
                }
            }
        ],
        "updated": "2025-02-04T17:40:14.689Z",
        "created": "2025-02-04T17:40:14.689Z"
    }
}
{
    "result": true,
    "data": {
        "uid": "4MR1URZ4D8FILOMNPU",
        "reference": "CR2332112121234",
        "test": true,
        "customerData": {
            "email": "demo@mobbex.com",
            "identification": "12123123",
            "name": "Test Demo"
        },
        "features": [],
        "status": "active",
        "sources": [
            {
                "uid": "W:T3J9TBMJFLVKU846WE",
                "name": "Tarjeta terminada en 6691",
                "type": "card",
                "priority": "primary",
                "card": {
                    "number": "47654068****6691",
                    "bin": "47654068",
                    "last4": "6691"
                }
            },
            {
                "uid": "W:36IXF2D0GYABJJYKXP",
                "name": "Tarjeta terminada en 1008",
                "type": "card",
                "priority": "secondary",
                "card": {
                    "number": "53236299****1008",
                    "bin": "53236299",
                    "last4": "1008"
                }
            }
        ],
        "updated": "2025-02-04T17:40:14.689Z",
        "created": "2025-02-04T17:40:14.689Z"
    }
}
﻿
Cambio de método de pago via Wallet
Permite cambiar el método de pago (guardado mediante "customerReference") a un suscriptor
POST
Request
Query Parameters
sid
String
required
ID de la suscripción.
subid
String
required
ID del suscriptor.
Header Parameters
x-api-key
String
required
Clave API de su aplicación.
x-access-token
String
required
Token de Acceso a la entidad para la cual desea realizar la operación.
Body Parameters
token
String
required
ID del token generado.
securityCode
String
required
Código de Seguridad de la tarjeta elegida.
﻿
Ejemplo Cambio de método de pago via Wallet
POST https://api.mobbex.com/p/subscriptions/H4QAGHOPE9QW6CUKVO/subscriber/5H1LBRT4WNGYFX3PUF/source
JSON
{
	"token": "W:T3J9TBMJFLVKU846WE",
	"securityCode": "200"
}
{
	"token": "W:T3J9TBMJFLVKU846WE",
	"securityCode": "200"
}
﻿
Respuesta
JSON
{
    "result": true,
    "data": {
        "status": "success",
        "code": "200",
        "text": "Operación Exitosa!",
        "operation": {
            "view": "default",
            "options": {},
            "id": "3EQRSGW7OJXHJDGADHN631",
            "status": {
                "code": "200",
                "text": "Aprobado",
                "message": "Transacción Aprobada",
                "data": {},
                "view": "default"
            },
            "total": 30.78,
            "currency": {
                "value": "TEST",
                "label": "Test Money",
                "symbol": "T$",
                "locale": "es",
                "isoCode": "000",
                "exponent": 2,
                "hidden": false
            },
            "data": [],
            "actions": []
        }
    }
}
{
    "result": true,
    "data": {
        "status": "success",
        "code": "200",
        "text": "Operación Exitosa!",
        "operation": {
            "view": "default",
            "options": {},
            "id": "3EQRSGW7OJXHJDGADHN631",
            "status": {
                "code": "200",
                "text": "Aprobado",
                "message": "Transacción Aprobada",
                "data": {},
                "view": "default"
            },
            "total": 30.78,
            "currency": {
                "value": "TEST",
                "label": "Test Money",
                "symbol": "T$",
                "locale": "es",
                "isoCode": "000",
                "exponent": 2,
                "hidden": false
            },
            "data": [],
            "actions": []
        }
    }
}
﻿
﻿
Updated 04 Feb 2025
Did this page help you?
Suscripciones con split
Métodos de Pago y Cuotas