Card Registration

Testing

Testing Env

https://provisioning.sipay.com.tr

POST

/ccpayment/api/saveCard

The Card Registration service is used to store card information in the Sipay System and to send back a token as the response to be used in the payByCardToken API.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Body

🟠400Failed

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://provisioning.sipay.com.tr/ccpayment/api/saveCard' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "merchant_key": "$2y$10$HmRgYosneqcwHj.UH7upGuyCZqpQ1ITgSMj9Vvxn.t6f.Vdf2SQFO",
  "card_holder_name": "John Doe",
  "card_number": 4508034508034509,
  "expiry_month": 12,
  "expiry_year": 2026,
  "customer_number": 5070,
  "customer_name": "John Doe",
  "customer_email": "john@doe.com",
  "customer_phone": 901111111111,
  "hash_key": "5353c46ffbca7b6e:9e99:Duykwf30yEY+RN1muHi8ZkoSkUjTaf0SRV2gEH__BrUyvfd",
  "app_lang": "en"
}'

Response Example

200 - Success

{
    "status_code": 100,
    "status_description": "The card token saved successfully",
    "card_token": "3acb729f7341c4fa4971a5b81b76189e"
}

Modified at 2026-01-30 07:52:33

Refund

Pay by Card Token