Kushki Developer Portal
  1. PAYMENT CREDENTIALS
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
        POST
      • 2. Search credentials
        POST
      • 3. Advanced search
        POST
      • 4. Activate or deactivate
        PATCH
      • 5. Delete credential
        DELETE
      • 6. Update credential
        PATCH
      • 7. Regenerate a credential
        PATCH
      • 3. Advanced search
        POST
      • 6. Update credential
        PATCH
      • 5. Delete credential
        DELETE
      • 2. Search credentials
        POST
      • 4. Activate or deactivate
        PATCH
      • 7. Regenerate a credential
        PATCH
      • 1. Create a credential
        POST
    • 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
    • States
    • Validate token
    • Municipalities
    • Collect payments
    • Tax companies
    • Capture an authorized payment
    • Commercial activities
    • Refund
    • Create checkout
    • Get status
    • Get checkout details
    • Collect card payments
    • Print Ticket
    • Collect card payments v2
    • Cancel Push Notification
    • Get transaction status
    • Add or update CLABE account
    • Configure payment link
    • Get payment link configuration
    • Create payment link
    • Update payment link
    • List payment links
    • Delete payment link
    • Add CLABE account
    • Get token
    • Get transaction list
    • Get transaction list v2
    • Get transaction list v3
    • Get transaction list v4
    • Create user
  1. PAYMENT CREDENTIALS

3. Advanced search

POST
/payment-credentials/v1/credential/suggestions

Request

Header Params

Body Params application/json

Examples

Responses

🟢200
application/json
Body

🟠401
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/payment-credentials/v1/credential/suggestions' \
--header 'Private-Merchant-Id: {{MX-Private-Merchant-Id}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "searchTerm": "21",
  "merchantId": "{{MX-merchant_id}}"
}'
Response Response Example
200 - 200 - Advanced search
{
    "data": [
        {
            "merchantId": "20000000104111374000",
            "privateCredentialId": "c136761707c346ec852b4dcabf82b13c",
            "publicCredentialId": "f1f2c3d524b2421388d1cd6842416efd",
            "enable": true,
            "alias": "Postman",
            "created": 1651157195450,
            "deleteAt": 0,
            "hidden": false,
            "credentialId": "01ab61ffd61140cd83d69c7c292ca932",
            "type": "master"
        },
        {
            "merchantId": "20000000104111374000",
            "privateCredentialId": "125c483c6da1410baf7e2e55c2968be7",
            "publicCredentialId": "295f9dea62f64d55acc873ebd8e87c5d",
            "enable": true,
            "alias": "Merchant MX",
            "created": 1650727730633,
            "deleteAt": 0,
            "hidden": false,
            "credentialId": "04b1d39627954fb1a550d86fde29d2eb",
            "type": "slave"
        },
        {
            "merchantId": "20000000104111374000",
            "privateCredentialId": "f590cec50df344baae1303c8eccac1a2",
            "publicCredentialId": "fae8e5b62e5f47b79d037e0b98ca7ca3",
            "enable": true,
            "alias": "credenciales de prueba",
            "created": 1655998902398,
            "deleteAt": 0,
            "hidden": false,
            "credentialId": "a4df085281b34af18e1af6842a1f82c0",
            "metadata": {
                "key1": "9006",
                "key2": "52727"
            },
            "type": "slave"
        },
        {
            "merchantId": "20000000104111374000",
            "privateCredentialId": "565981b06d0c4c0c8dc6660ba616f894",
            "publicCredentialId": "5776562bac9b44d0aef1342c29eac0e5",
            "enable": true,
            "alias": "credenciales",
            "created": 1656509499760,
            "deleteAt": 0,
            "hidden": false,
            "credentialId": "b4e9a89d457e45caa38c81b4921f2a43",
            "metadata": {
                "key1": "9006",
                "key2": "52727"
            },
            "type": "slave"
        },
        {
            "merchantId": "20000000104111374000",
            "privateCredentialId": "125c483c6da1410baf7e2e55c2968be7",
            "publicCredentialId": "295f9dea62f64d55acc873ebd8e87c5d",
            "enable": true,
            "alias": "Merchant MX",
            "created": 1650727730633,
            "deleteAt": 0,
            "hidden": false,
            "credentialId": "04b1d39627954fb1a550d86fde29d2eb",
            "type": "slave"
        },
        {
            "merchantId": "20000000104111374000",
            "privateCredentialId": "c136761707c346ec852b4dcabf82b13c",
            "publicCredentialId": "f1f2c3d524b2421388d1cd6842416efd",
            "enable": true,
            "alias": "Postman",
            "created": 1651157195450,
            "deleteAt": 0,
            "hidden": false,
            "credentialId": "01ab61ffd61140cd83d69c7c292ca932",
            "type": "master"
        },
        {
            "merchantId": "20000000104111374000",
            "privateCredentialId": "f590cec50df344baae1303c8eccac1a2",
            "publicCredentialId": "fae8e5b62e5f47b79d037e0b98ca7ca3",
            "enable": true,
            "alias": "credenciales de prueba",
            "created": 1655998902398,
            "deleteAt": 0,
            "hidden": false,
            "credentialId": "a4df085281b34af18e1af6842a1f82c0",
            "metadata": {
                "key1": "9006",
                "key2": "52727"
            },
            "type": "slave"
        },
        {
            "merchantId": "20000000104111374000",
            "privateCredentialId": "125c483c6da1410baf7e2e55c2968be7",
            "publicCredentialId": "295f9dea62f64d55acc873ebd8e87c5d",
            "enable": true,
            "alias": "Merchant MX",
            "created": 1650727730633,
            "deleteAt": 0,
            "hidden": false,
            "credentialId": "04b1d39627954fb1a550d86fde29d2eb",
            "type": "slave"
        },
        {
            "merchantId": "20000000104111374000",
            "privateCredentialId": "565981b06d0c4c0c8dc6660ba616f894",
            "publicCredentialId": "5776562bac9b44d0aef1342c29eac0e5",
            "enable": true,
            "alias": "credenciales",
            "created": 1656509499760,
            "deleteAt": 0,
            "hidden": false,
            "credentialId": "b4e9a89d457e45caa38c81b4921f2a43",
            "metadata": {
                "key1": "9006",
                "key2": "52727"
            },
            "type": "slave"
        },
        {
            "merchantId": "20000000104111374000",
            "privateCredentialId": "c136761707c346ec852b4dcabf82b13c",
            "publicCredentialId": "f1f2c3d524b2421388d1cd6842416efd",
            "enable": true,
            "alias": "Postman",
            "created": 1651157195450,
            "deleteAt": 0,
            "hidden": false,
            "credentialId": "01ab61ffd61140cd83d69c7c292ca932",
            "type": "master"
        },
        {
            "merchantId": "20000000104111374000",
            "privateCredentialId": "f590cec50df344baae1303c8eccac1a2",
            "publicCredentialId": "fae8e5b62e5f47b79d037e0b98ca7ca3",
            "enable": true,
            "alias": "credenciales de prueba",
            "created": 1655998902398,
            "deleteAt": 0,
            "hidden": false,
            "credentialId": "a4df085281b34af18e1af6842a1f82c0",
            "metadata": {
                "key1": "9006",
                "key2": "52727"
            },
            "type": "slave"
        }
    ],
    "total": 11
}
Modified at 2026-01-06 19:33:02
Previous
7. Regenerate a credential
Next
6. Update credential
Built with