Create a credential

POST

/payment-credentials/v1/credential

This endpoint allows you to create a new credential with its corresponding public and private keys.

Note: to use this endpoint you must obtain first a main or master credential for your merchant. It can be generated by a Credential Master user (available only on demand).

Request

Header Params

Body Params application/json

Examples

Responses

🟢201

application/json

Bodyapplication/json

🟠400

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-uat.kushkipagos.com/payment-credentials/v1/credential' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data '{
    "alias": "",
    "enable": false,
    "hidden": true,
    "merchant_id": "string",
    "metadata": {
        "key0": "value0",
        "key1": "value1",
        "key2": "value2"
    }
}'

Response Example

201 - Credential created

{
    "alias": "Credencial de prueba",
    "credential_id": "f4c644b64951620ab8952ad58pl63901",
    "metadata": null,
    "private_credential_id": "c381037a5bfb00f2bd0ee899eb85fllq",
    "public_credential_id": "345213d7d1c64ba28eb88a3b4f1ab0b9"
}

Modified at 2026-07-10 20:38:40

Payment Credentials

Activate or deactivate