Obtener el historial de transacciones
El SDK de Clip permite obtener el historial de transacciones que se han realizado.
Las funciones disponibles para trabajar con el historial son las siguientes:
- getTransactionHistory(by: TransactionHistoryQuery): permite realizar una búsqueda de transacciones del mismo día y aplicar distintos filtros.
do {
try TransactionHistory.shared.getTransactionHistory(by:.date(Date()) { (result) in
switch result {
case .success(let transactions):
case .failure(let error):
}
catch {
print(error)
}|
Elemento |
Tipo de Dato |
Descripción |
||
|
TransactionHistoryQuery |
Enum |
Tipo de búsqueda |
||
|
|
.card(last4: String) |
|
Últimos 4 dígitos de la tarjeta. Se valida que el parámetro tenga el siguiente formato: "^\d{0,4}$" De no cumplir con el formato se regresa un error de tipo: InvalidParameterFormat |
|
|
|
.date(Foundation.Date) |
|
Fecha en que se realizó el pago. |
|
|
|
.receipt(receiptNum: String) |
|
Número de evoucher generado por Clip. Se valida que el parámetro tenga el siguiente formato: "^[a-zA-Z0-9-_]{0,}$" De no cumplir con el formato se regresa un error de tipo: InvalidParameterFormat |
|
La siguiente tabla muestra los elementos en el objeto de respuesta ClipTransaction que regresan las funciones anteriores:
|
Elemento |
Descripción |
Tipo de dato |
|||
|
receiptNumber |
Identificador único de la transacción |
String |
|||
|
amount |
Cantidad del pago |
Decimal |
|||
|
tip |
Cantidad de la propina |
Decimal |
|||
|
totalAmount |
Cantidad total del pago incluyendo propina |
Decimal |
|||
|
cardType |
Tipo de tarjeta utilizada para el pago:
CardType
|
Enum |
|||
|
last4 |
Últimos cuatro dígitos de la tarjeta utilizada para el pago |
String |
|||
|
installment |
Indica si el pago se difiere en mensualidades:
Installment
|
Enum |
|||
|
merchantInvoiceId |
Referencia alfanumérica proporcionada por el vendedor |
String |
|||
|
status |
Estado de la transacción. Lista de posibles estados de la transacción:
TransactionStatus
|
Enum |
|||
|
currency |
Código de divisa para la transacción del pago conforme a ISO 4217 |
String |
|||
|
paymentDate |
Fecha de creación del pago |
Date |
|||
|
latitude |
Coordenada de latitud para la ubicación de la transacción |
String |
|||
|
longitude |
Coordenada de longitud para la ubicación de la transacción |
String |
|||
