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)

Collect card payments v2

POST
/v2/push-notifications
Send a payment request from your POS to a compatible terminal over the internet.

Response codes#

Below is a list of response codes returned via the responseCode property in the response on error
responseCodeDescription
001Authentication problems. Please check that your token and header are valid.
002Error in the information sent. Please check that the properties and their information are valid.
003Error with the terminal serial number. Please check that the terminal serial number is correct.
004Duplicate unique reference. Transaction with CREATED status.
005Duplicate unique reference. Transaction with CANCELLED status.
006Duplicate unique reference. Transaction with APPROVED status.
007Duplicate unique reference. Transaction with REFUNDED status.
010The device token sent does not exist
100Error registering unique reference. Please check that the information submitted is correct and try again.
101Error sending notification to terminal. Check that the terminal is on and has internet access and try again.

Request

Header Params

Body Params application/json

Examples

Responses

🟠400
application/json
Bad Request
Body

🟠401
🟠404
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST '/v2/push-notifications' \
--header 'X-BP-AUTH;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "serialNumber": "TERM123",
    "amount": 37,
    "identifier": "c68522bd-bfc1-4b08-bf99-30300806c25a",
    "uniqueReference": "100123"
}'
Response Response Example
400 - serialNumber must not contain special characters
{
    "message": [
        "serialNumber must not contain special characters"
    ],
    "responseCode": "002"
}
Modified at 2026-01-29 23:52:15
Previous
Print Ticket
Next
Cancel Push Notification
Built with