Cobrar pagos

Haz una solicitud para procesar un pago único, una autorización o un cargo recurrente desde una tarjeta tokenizada previamente.

Pago único

Estas son las propiedades requeridas para procesar un pago único.

PROPIEDAD	DESCRIPCIÓN
apiKey	API key.
cardToken	Token de tarjeta.
cvv	3 dígitos para tarjetas Visa y Mastercard; 4 dígitos para tarjetas American Express.
amount	Monto de la transacción.

Ejemplo de pago único

{
  "apiKey": "ojLGcX1ioiAA8FkAAETcOxoAApkpBcQfki80AAAHSsVvA",
  "cardToken": "ntY50io0uijCQGnjVH49DSuc-41kI6y0_WgmYzZcShQAA17r1RPbXqGdFfApcNq73iU1vwAA8Fk0oplw",
  "cvv": "111",
  "amount": 100
}

Autorización

Estas son las propiedades requeridas para procesar una autorización.

PROPIEDAD	DESCRIPCIÓN
apiKey	API key.
cardToken	Token de tarjeta.
cvv	3 dígitos para tarjetas Visa y Mastercard; 4 dígitos para tarjetas American Express.
amount	Monto de la transacción.
txnType	Envía el valor `checkIn`.

Nota: tienes 20 días para capturar una autorización. Pasado ese plazo, el banco emisor libera los fondos retenidos y los devuelve al tarjetahabiente.

Ejemplo de una autorización

{
  "apiKey": "ojLGcX1ioiAA8FkAAETcOxoAApkpBcQfki80AAAHSsVvA",
  "cardToken": "ntY50io0uijCQGnjVH49DSuc-41kI6y0_WgmYzZcShQAA17r1RPbXqGdFfApcNq73iU1vwAA8Fk0oplw",
  "cvv": "111",
  "amount": 100,
  "txnType": "checkIn"
}

Cargo recurrente

Estas son las propiedades requeridas para procesar un cargo recurrente.

PROPIEDAD	DESCRIPCIÓN
apiKey	API key.
cardToken	Token de tarjeta.
cvv	3 dígitos para tarjetas Visa y Mastercard.
amount	Monto de la transacción.
txnType	Envía el valor `recurring`.
contractNumber	Número de contrato.

Nota: las tarjetas American Express no son compatibles con transacciones recurrentes.

Ejemplo de un cargo recurrente

{
  "apiKey": "ojLGcX1ioiAA8FkAAETcOxoAApkpBcQfki80AAAHSsVvA",
  "cardToken": "ntY50io0uijCQGnjVH49DSuc-41kI6y0_WgmYzZcShQAA17r1RPbXqGdFfApcNq73iU1vwAA8Fk0oplw",
  "cvv": "111",
  "amount": 100,
  "txnType": "recurring",
  "contractNumber": "contract123"
}

Cargo recurrente checkIn

Estas son las propiedades requeridas para procesar un cargo recurrente checkIn.

PROPIEDAD	DESCRIPCIÓN
apiKey	API key.
cardToken	Token de tarjeta.
cvv	3 dígitos para tarjetas Visa y Mastercard.
amount	Monto de la transacción.
txnType	Envía el valor `recurringCheckIn`.
contractNumber	Número de contrato.

Nota: las tarjetas American Express no son compatibles con transacciones recurring checkIn.

Ejemplo de un cargo recurrente checkIn

{
  "apiKey": "ojLGcX1ioiAA8FkAAETcOxoAApkpBcQfki80AAAHSsVvA",
  "cardToken": "ntY50io0uijCQGnjVH49DSuc-41kI6y0_WgmYzZcShQAA17r1RPbXqGdFfApcNq73iU1vwAA8Fk0oplw",
  "cvv": "111",
  "amount": 100,
  "txnType": "recurringCheckIn",
  "contractNumber": "contract123"
}

Diferidos

Estas son las propiedades requeridas para procesar un pago diferido.

PROPIEDAD	DESCRIPCIÓN
apiKey	API key.
cardToken	Token de tarjeta.
cvv	3 dígitos para tarjetas Visa y Mastercard; 4 dígitos para tarjetas American Express.
amount	Monto de la transacción.
paymentPlan	Número de meses de diferido.

Ejemplo de un pago diferido

{
  "apiKey": "ojLGcX1ioiAA8FkAAETcOxoAApkpBcQfki80AAAHSsVvA",
  "cardToken": "ntY50io0uijCQGnjVH49DSuc-41kI6y0_WgmYzZcShQAA17r1RPbXqGdFfApcNq73iU1vwAA8Fk0oplw",
  "cvv": "111",
  "amount": 600,
  "paymentPlan": 3

}

Pago único con tarjetas American Express sin 4DBC

Estas son las propiedades requeridas para procesar un pago único con tarjetas American Express sin 4DBC.

PROPIEDAD	DESCRIPCIÓN
apiKey	API key.
cardToken	Token de tarjeta.
amount	Monto de la transacción.
amexCustAddress	Dirección de facturación del tarjetahabiente.
amexCustFirstName	Nombre del tarjetahabiente.
amexCustLastName	Apellido del tarjetahabiente.
amexCustEmailAddr	Correo electrónico del tarjetahabiente.
amexCustBrowserTypDescTxt	User agent del cliente.
amexCustHostServerNm	Nombre del servidor host del cliente.
amexCustIdPhoneNbr	Número de teléfono del tarjetahabiente.
amexCustIPAddr	Dirección IP del cliente.
amexCustPostalCode	Código postal de facturación del tarjetahabiente.
amexMerSKUNbr	Número de SKU del comercio.

Ejemplo de un pago único con tarjetas American Express sin 4DBC

{
  "apiKey": "ojLGcX1ioiAA8FkAAETcOxoAApkpBcQfki80AAAHSsVvA",
  "cardToken": "ntY50io0uijCQGnjVH49DSuc-41kI6y0_WgmYzZcShQAA17r1RPbXqGdFfApcNq73iU1vwAA8Fk0oplw",
  "amount": 100,
  "amexCustAddress": "18850 N 56 ST APT301",
  "amexCustFirstName": "JANE",
  "amexCustLastName" : "SMITH",
  "amexCustEmailAddr": "jane@smith.com",
  "amexCustBrowserTypDescTxt": "MOZILLA/4.0~(COMPATIBLE;~MSIE~5.0;  ~WINDOWS~95",
  "amexCustHostServerNm" : "comercio.com",
  "amexCustIdPhoneNbr" : "3333333333",
  "amexCustIPAddr" : "169.10.10.10",
  "amexCustPostalCode" : "00001",
  "amexMerSKUNbr" : "MYSKU0001"
}

Pagos sin token

Puedes cobrar pagos sin necesidad de tokenizar la tarjeta primero. Envía los datos de la tarjeta dentro del objeto cardReq en lugar de enviar la propiedad cardToken con el token de la tarjeta.

Estas son las propiedades requeridas para procesar un pago sin generar un token de tarjeta.

PROPIEDAD	DESCRIPCIÓN
apiKey	API key.
cardReq	Objeto con la información de la tarjeta.
cardReq.pan	Número de cuenta principal (PAN).
cardReq.cvv2	3 dígitos para tarjetas Visa y Mastercard; 4 dígitos para tarjetas American Express.
cardReq.expDate	Fecha de vencimiento (`YYMM`).
amount	Monto de la transacción.

Ejemplo de un pago sin token

{
  "apiKey": "ojLGcX1ioiAA8FkAAETcOxoAApkpBcQfki80AAAHSsVvA",
  "cardReq" : {
    "pan" : "4000000000000002", 
    "cvv2" : "111", 
    "expDate" : "3012"
  },
  "amount": 100
}

curl --location '/scops/txn' \ --header 'Content-Type: application/json' \ --data '{ "apiKey": "ojLGcX1ioiAA8FkAAETcOxoAApkpBcQfki80AAAHSsVvA", "cardToken": "ntY50io0uijCQGnjVH49DSuc-41kI6y0_WgmYzZcShQAA17r1RPbXqGdFfApcNq73iU1vwAA8Fk0oplw", "cvv": "111", "amount": 100 }'

Pago único

Ejemplo de pago único

Autorización

Ejemplo de una autorización

Cargo recurrente

Ejemplo de un cargo recurrente

Cargo recurrente checkIn

Ejemplo de un cargo recurrente checkIn

Diferidos

Ejemplo de un pago diferido

Pago único con tarjetas American Express sin 4DBC

Ejemplo de un pago único con tarjetas American Express sin 4DBC

Pagos sin token

Ejemplo de un pago sin token

Request

Responses

Cobrar pagos

Pago único#

Ejemplo de pago único#

Autorización#

Ejemplo de una autorización#

Cargo recurrente#

Ejemplo de un cargo recurrente#

Cargo recurrente checkIn#

Ejemplo de un cargo recurrente checkIn#

Diferidos#

Ejemplo de un pago diferido#

Pago único con tarjetas American Express sin 4DBC#

Ejemplo de un pago único con tarjetas American Express sin 4DBC#

Pagos sin token#

Ejemplo de un pago sin token#

Request

Responses

Pago único

Ejemplo de pago único

Autorización

Ejemplo de una autorización

Cargo recurrente

Ejemplo de un cargo recurrente

Cargo recurrente checkIn

Ejemplo de un cargo recurrente checkIn

Diferidos

Ejemplo de un pago diferido

Pago único con tarjetas American Express sin 4DBC

Ejemplo de un pago único con tarjetas American Express sin 4DBC

Pagos sin token

Ejemplo de un pago sin token