Methods to control cards
This method can be used to send a request to a 3rd party service (eg. OTA or CM) and extract the credit card information from the response (e.g. Booking with card details inside).
Any provided Headers or Content Body will be provided to Target endpoint without any changes.
Method will return answer from Target Endpoint. Credit Card data will be masked based at Tokenization Profile settings.
Credit card token can be returned at Header X-PCI-CHANNEX-TOKENS or inside specific node at response body.
To get Credit Card information from your Guests, you can use Capture Card Embedded Form.
This method return HTML Page what you can embed into your application to collect Card information from clients.
Sometimes you would like to save a Card directly with Channex PCI. To do that, you can use this method.
"cardholder_name": "JOHN DOE",
"cardholder_name": "JHON DOE",
Method will return success response with code
200 OK. Response will contain
credit cardinfo with masked fields and
card_tokenwhich can be used for another operations with cards.
This is useful if you wish to move cards from another PCI Service to Channex.
To send card to a 3rd party service (e.g. Payment Gateway), you can use the the Send Card method:
Send card to Stripe
Authorization: Basic encode_base64("sk_stripe_key:<stripe_key>")
Method with return response from Target Endpoint.
By PCI DSS rules, we should remove Service Code immediately after the card is Authorized. Some operations at our API call this action automatically. But, because you can catch some problems with Send Card method (3rd party service provide error response), we do not remove Service Code automatically after using the Send Card Method. If your application successfully sent the card info to the 3rd party service, please call Authorize Card method.
Please use this method to remove the service code once you have successfully sent the card to the payment gateway. This is an important part of PCI-DSS.
Status: 204 No Content
If card is not longer required for your business processes, you should remove it from storage by calling this method:
Status: 204 No Content
To implement the ability to Show Card at your application you can use method Show Card. This method will return HTML Page with credit card information that you can insert into your application.
By default, Channex PCI will return a HTML page where user can see Card Number, Expiration Date, Card Type and Cardholder Name, but Service Code (CVV, CVC) will be hidden. To be able to see Service code, you should provide the service_code_token which will be used to request Service Code.
Service Code will be hidden by a button, by clicking this button the user will load Service Code and it will be immediately removed from Storage.
Our iframe to show card information makes the user click to see the service code (CVV/CVC). This is helpful because once it is viewed it must be deleted.