Kushki Developer Portal
  1. CARD PRESENT PAYMENTS (BILLPOCKET)
Kushki Developer Portal
  • Back to home
  • México 🇲🇽
  • Bienvenidos
  • ONLINE PAYMENTS
    • CARD
      • CARD
      • 1. Request a card token
      • 2. Make a charge or deferred charge
      • 3. Void a transaction
      • 4. Refund a transaction
      • 5. Request deferred options
      • 6. Authorize payments
      • 7. Reauthorize payments
      • 8. Capture an authorized payment
      • 9. Bin Info
      • 10. Bin Info V2
      • 11. Validate OTP
      • 12. Verify Account
      • 12. Verify Account
      • 6. Authorize payments
      • 10. Bin Info V2
      • 8. Capture an authorized payment
      • 3. Void a transaction
      • 4. Refund a transaction
      • 7. Reauthorize payments
      • 1. Request a card token
      • 9. Bin Info
      • 5. Request deferred options
      • 2. Make a charge or deferred charge
      • 11. Validate OTP
    • CASH IN
      • 1. Request a cash in token
      • 2. Init Transaction
      • 3. Transaction Status
      • 1. Request a cash in token
      • 2. Init Transaction
      • 3. Transaction Status
    • TRANSFER IN
      • 1. Request a Transfer In token
      • 2. Init Transaction
      • 4. Get Status Copy
      • 1. Request a Transfer In token
      • 4. Get Status Copy
      • 2. Init Transaction
    • TRANSFER OUT
      • 1. Get Bank List
      • 2. Request a Transfer Out token
      • 3. Init Transaction
      • 4. Get Status
      • 5. Wallet Balance
      • 5. Wallet Balance
      • 1. Get Bank List
      • 4. Get Status
      • 2. Request a Transfer Out token
      • 3. Init Transaction
    • ONE-CLICK & SCHEDULED PAYMENTS
      • 1. Request a recurring charge token
      • 2. Create a recurring charge
      • 3. Update recurring charge card data
      • 4. Make an One-click payment
      • 5. Cancel a recurring charge
      • 6. Update a recurring charge
      • 7. Add a temporary charge or discount
      • 8. Authorize payments Copy
      • 9. Capture an authorized payment Copy
      • 10. Get recurring charge Info
      • 1. Request a recurring charge token
      • 8. Authorize payments Copy
      • 3. Update recurring charge card data
      • 6. Update a recurring charge
      • 10. Get recurring charge Info
      • 2. Create a recurring charge
      • 5. Cancel a recurring charge
      • 9. Capture an authorized payment Copy
      • 4. Make an One-click payment
      • 7. Add a temporary charge or discount
    • PAYMENT BUTTON
      • 1. Create a payment button
      • 1. Create a payment button
    • SMARTLINKS V2
      • 1. Create a Smartlink
      • 2. Get a Smartlink
      • 3. Delete a Smartlink
      • 4. Update a Smartlink
      • 1. Create a Smartlink
      • 4. Update a Smartlink
      • 2. Get a Smartlink
      • 3. Delete a Smartlink
    • PAYMENT CREDENTIALS
      • 1. Create a credential
      • 2. Search credentials
      • 3. Advanced search
      • 4. Activate or deactivate
      • 5. Delete credential
      • 6. Update credential
      • 7. Regenerate a credential
      • 3. Advanced search
      • 6. Update credential
      • 5. Delete credential
      • 2. Search credentials
      • 4. Activate or deactivate
      • 7. Regenerate a credential
      • 1. Create a credential
    • COMMISSIONS
      • 1. Get Commission Configuration
      • 1. Get Commission Configuration
    • GATEWAY STATUS
      • 1. Get gateway status
      • 1. Get gateway status
    • ANALYTICS
      • 1. Get transactions list
      • 1. Get transactions list
  • CARD PRESENT PAYMENTS (API RAW)
    • Single payment
    • Get BIN Info
    • BIN info V2
    • Request deferred options
    • Transaction Search
  • CARD PRESENT PAYMENTS (BILLPOCKET)
    • Get token
      POST
    • States
      GET
    • Validate token
      GET
    • Municipalities
      GET
    • Collect payments
      POST
    • Tax companies
      GET
    • Capture an authorized payment
      POST
    • Commercial activities
      GET
    • Refund
      POST
    • Create checkout
      POST
    • Get status
      GET
    • Get checkout details
      GET
    • Collect card payments
      POST
    • Print Ticket
      POST
    • Collect card payments v2
      POST
    • Cancel Push Notification
      POST
    • Get transaction status
      GET
    • Add or update CLABE account
      POST
    • Configure payment link
      POST
    • Get payment link configuration
      GET
    • Create payment link
      POST
    • Update payment link
      PUT
    • List payment links
      GET
    • Delete payment link
      DELETE
    • Add CLABE account
      POST
    • Get token
      POST
    • Get transaction list
      GET
    • Get transaction list v2
      GET
    • Get transaction list v3
      GET
    • Get transaction list v4
      GET
    • Create user
      POST
  1. CARD PRESENT PAYMENTS (BILLPOCKET)

Get transaction list

GET
/api/v1/transactions
Obtain the list of transactions processed with your business from a defined date range. By default, 100 elements are returned per page with a maximum of 600 elements. It is necessary to specify the start and end date of the query.
Sorted by most recent
Only transactions older than 60 seconds are returned.

Filters#

You can use the following filters to get better results.

PROPERTYDESCRIPTIONALLOWED VALUESEXAMPLE
dateFromFind transactions from a specific date. yyyy-mm-ddthh:mm:ss format.2022-01-11T10:20:00
dateToFind transactions up to a specific date. yyyy-mm-ddthh:mm:ss format.2023-06-20T11:59:00
binFilter by BIN number.557908
captureMethodFilter by capture method.ec, emvf, nfc, msc, key, recec
cardFilter by masked card number.310583******5037
deviceFilter by device name.test
pageindicates the page number of the results.5
sizeNumber of transactions to return. Default: 100. Max: 600.150
transactionStatusFilter by transaction status.aprobada, pendiente, rechazadaRiesgo, rechazada, rechazadaProsaaprobada
transactionTypeFilter by transaction type.venta, devolucion, checkoutcheckout
transactionIdFilter by transaction ID.TRX1234
referenceFilter by transaction reference.reference123

Request

Query Params

Header Params

Responses

🟢200
application/json
OK
Body

🟠401
🟠404
🟠422
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/v1/transactions?dateFrom&dateTo&bin&captureMethod&card&device&page&size&transactionStatus&transactionType&transactionId&reference' \
--header 'Authorization;'
Response Response Example
200 - Transaction list
{
    "data": [
        {
            "transaction_id": 130215,
            "authorization_number": "",
            "bank": null,
            "card_brand": "Visa",
            "card_type": null,
            "capture_method": "msc",
            "commission": 0.49,
            "countercharged": false,
            "date": "2024-07-12T10:09:26.000Z",
            "details": null,
            "device": "Device 1",
            "error_detail": "Rechazo por reglas internas",
            "masked_card": "400000******0002",
            "msi": null,
            "retention": 0,
            "rejection_code": null,
            "subtotal": 13.48,
            "surcharge": 0,
            "tip": 0,
            "total_amount": 14.05,
            "transaction_type": "venta",
            "transaction_status": "rechazadaRiesgo",
            "vat": 0.08
        },
        {
            "transaction_id": 130214,
            "authorization_number": "N/D",
            "bank": null,
            "card_brand": "Visa",
            "card_type": null,
            "capture_method": "msc",
            "commission": 0.49,
            "countercharged": false,
            "date": "2024-07-12T09:48:48.000Z",
            "details": null,
            "device": "Device 1",
            "error_detail": "",
            "masked_card": "400000******0002",
            "msi": null,
            "retention": 0,
            "rejection_code": null,
            "subtotal": 13.48,
            "surcharge": 0,
            "tip": 0,
            "total_amount": 14.05,
            "transaction_type": "devolucion",
            "transaction_status": "aprobada",
            "vat": 0.08
        },
        {
            "transaction_id": 130213,
            "authorization_number": "BP2033",
            "bank": null,
            "card_brand": "Visa",
            "card_type": "CREDIT",
            "capture_method": "msc",
            "commission": 0.49,
            "countercharged": false,
            "date": "2024-07-12T09:39:16.000Z",
            "details": null,
            "device": "Device 1",
            "error_detail": "",
            "masked_card": "400000******0002",
            "msi": null,
            "retention": 0,
            "rejection_code": null,
            "subtotal": 13.48,
            "surcharge": 0,
            "tip": 0,
            "total_amount": 14.05,
            "transaction_type": "venta",
            "transaction_status": "aprobada",
            "vat": 0.08
        }
    ],
    "currentPage": 1,
    "perPage": 100,
    "total": 3
}
Modified at 2026-01-30 00:43:25
Previous
Get token
Next
Get transaction list v2
Built with