Submit card data

This endpoint is used depending on the type of integration. Please check with our integration team if you are eligible for using this endpoint.

Sending card data for a payin

Submit card

POST {next_action.url}

Sends PAN, card expiry date and CSC to perform a transaction.

Headers

Name	Type	Description
x-merchant-id*	string
x-timestamp*	number
x-simplified-signature*	string	x-simplified-signature

Request Body

Name	Type	Description
payin_id*	string
card.exp_year*	string	YYYY format (e.g. 2048)
card.exp_month*	string	MM format (e.g. 01)
card.pan*	string	16 digits, no spaces or dashes
card.csc*	string	XXX format (e.g. 012)

200 Card data accepted

{
  "next_action": {
    "type": "string",
    "url": "string"
  }
}

400: Bad Request Card data submission failed

Returns the respective error message with the error details.

401: Unauthorized Signature validation failed

Your signature generation may not be set up correctly or you are using an incorrect public or secret key.

403: Forbidden Access denied

Your merchant account may not have been fully set up. Please contact us for assistance.

422: Unprocessable Entity Invalid request

You might have issue with the integration. Please contact us and provide your request payload for investigation.

Please note, this request is not sent to the Kitopay API directly, it is sent to the URL that will be provided dynamically in the transaction creation request response (next_action.url) in order to securely process the sensitive card data according to the PCI DSS standards with the help of our certified partners.

Example

curl -X POST 'https://pci.url.tld/dynamic/path/' \
-H 'Content-Type: application/json' \
-H 'x-merchant-id: dev_pub_fb1dad5f-5982-4e1a-ac2f-62a7daaa7148' \
-H 'x-timestamp: 1601234567' \
-H 'x-simplified-signature: b3b7b638c8a755b3989011b6a5ff4cd0a94236764ee119724a6e0ea55c4e3c83' \
-d '{
    "payin_id": "2fda990a-88cf-445e-abd1-b9bc0a23f4cc",
    "card": {
        "pan": "4242090942421919",
        "exp_month": "02",
        "exp_year": "2028",
        "csc": "012"
    }
}'