E-commerce Flex

Acepta pagos en tu tienda en línea con control total del flujo de pago. Tokeniza una tarjeta y haz cargos únicos, autorizaciones con captura, cargos recurrentes y reembolsos, todo desde una API REST directa.

INFO

Servicio disponible solo en México.

Requisitos

Una cuenta válida

Una API key

Entornos

Entorno	URL base
Dev	`https://lancehorn.billpocket.dev`
Live	`https://lancehorn.billpocket.com`

Obtener un token de tarjeta

POST /scops/card

Tokeniza el PAN del tarjetahabiente antes de procesar un pago. Envía el número de tarjeta, la fecha de vencimiento (YYMM) y tu API key.

Solicitud:

{
  "pan": "4000000000000002",
  "expDate": "3012",
  "apiKey": "myAPIKey"
}

Respuesta:

{
  "status": 1,
  "message": "Card stored successfully",
  "cardToken": "zJ3STsWSaEsoc6YTyTsWV1S-WI0_czchV1doc6YTy-WI0_czchV1d",
  "maskedPAN": "400000******0002"
}

Validar un token

GET /scops/card/{cardToken}?api_key={apiKey}

Verifica si un token es válido antes de cobrar. Un status: 1 significa que el token existe y contiene datos de tarjeta válidos.

Respuesta:

{
  "status": 1,
  "message": "Card does exist",
  "maskedPAN": "400000******0002"
}

Cobrar un pago

POST /scops/txn

Procesa un cargo contra una tarjeta tokenizada. Tipos de transacción soportados:

Pago único

{
  "apiKey": "myAPIKey",
  "cardToken": "zJ3STsWSaE...",
  "cvv": "111",
  "amount": 500
}

Autorización (preautorización)

{
  "apiKey": "myAPIKey",
  "cardToken": "zJ3STsWSaE...",
  "cvv": "111",
  "amount": 500,
  "txnType": "checkIn"
}

Cargo recurrente

{
  "apiKey": "myAPIKey",
  "cardToken": "zJ3STsWSaE...",
  "cvv": "111",
  "amount": 500,
  "txnType": "recurring",
  "contractNumber": "contract123"
}

Diferido (MSI)

{
  "apiKey": "myAPIKey",
  "cardToken": "zJ3STsWSaE...",
  "cvv": "111",
  "amount": 600,
  "paymentPlan": 3
}

Sin token

{
  "apiKey": "myAPIKey",
  "cardReq": {
    "pan": "4000000000000002",
    "cvv2": "111",
    "expDate": "3012"
  },
  "amount": 500
}

Respuesta aprobada:

{
  "value": {
    "status": 1,
    "message": "APROBADA",
    "opId": 128540,
    "txnISOCode": "00",
    "authNumber": "BP0190",
    "ticketUrl": "38cca53d999...",
    "amount": 500,
    "maskedPAN": "400000******0002",
    "dateTime": 1717721589822
  }
}

Capturar una autorización

POST /scops/txn/checkout

Captura una autorización previa. Omite amount para una captura total o envía un monto menor para una captura parcial.

INFO

Tienes 20 días para capturar una autorización. Pasado ese plazo, el banco emisor libera los fondos retenidos.

Captura total:

{
  "apiKey": "myAPIKey",
  "opId": 128612
}

Captura parcial:

{
  "apiKey": "myAPIKey",
  "opId": 128612,
  "amount": 250
}

Respuesta:

{
  "status": 1,
  "message": "APROBADA",
  "opId": 128802,
  "txnISOCode": "00",
  "maskedPAN": "424242******4242",
  "dateTime": 1718138178662
}

Reembolso

POST /scops/txn/refund

Solicita un reembolso total o parcial. Omite amount para un reembolso total o envía un monto menor para un reembolso parcial.

{
  "apiKey": "myAPIKey",
  "opId": 128612,
  "amount": 200
}

Respuesta:

{
  "status": 1,
  "message": "APROBADA",
  "opId": 128608,
  "txnISOCode": "00",
  "maskedPAN": "400000******0002",
  "dateTime": 1717772908535
}

Consultar el estado de una transacción

GET /scops/txn/{opId}?api_key={apiKey}

Consulta el estado y los detalles de una transacción anterior.

Respuesta:

{
  "status": 1,
  "opId": 124100,
  "txnISOCode": "00",
  "txnISOTextual": "APROBADA",
  "authNumber": "BPCK01",
  "ticketUrl": "7cfa45251c4...",
  "amount": 500,
  "maskedPAN": "400000******0002",
  "dateTime": 1703624741000,
  "captureIndicator": "0"
}

Siguientes pasos

Revisa la referencia de la API de E-commerce Flex

Usa tarjetas de prueba para simular pagos

¿Tienes una sugerencia sobre esta documentación? Contáctanos.

Requisitos#

Entornos#

Obtener un token de tarjeta#

Validar un token#

Cobrar un pago#

Pago único#

Autorización (preautorización)#

Cargo recurrente#

Diferido (MSI)#

Sin token#

Capturar una autorización#

Reembolso#

Consultar el estado de una transacción#

Siguientes pasos#

Requisitos

Entornos

Obtener un token de tarjeta

Validar un token

Cobrar un pago

Pago único

Autorización (preautorización)

Cargo recurrente

Diferido (MSI)

Sin token

Capturar una autorización

Reembolso

Consultar el estado de una transacción

Siguientes pasos