Store Credentials
POST {{base_path_test}}{{endpoint_store_credentials}}
A stored credential (CoF) is information that is stored by a Merchant or its agent, a payment facilitator, or a staged digital wallet operator to process future transactions. A card-absent transaction is initiated by the Customer where the Customer does not need to enter his/hers card details as the Merchant uses the payment credential previously stored by the Customer to perform the transaction. Store credentials must always be initiated by the Customer.
NOTE! This endpoint illustrates the first transaction where the Customer is storing his/hers credentials. For details on transactions using these credentials, refer to CoF
Two scenarios apply when storing credentials:
Customer Stores Credentials Only
Customer has created a profile in a wallet, and now he wants to store his credit card with his profile to use for future purchases. The Customer is redirected to a page where he enters his/hers card details, and subsequently the Customer is authenticated using 3DSecure. Once successfully done, the initial transaction is created by sending a request, where the card details shall be checked and stored as credentials on file.
For this scenario the following parameters must be as follows: * inquiry = true * d4 = 0 * d22cp = INTERNET * capture = false
Customer Stores Credentials with Purchase
Customer has selected items to purchase online, and now selects checkout. The Customer has provided all necessary details, such as card details, shipping details, name, and finally selects to store his/hers profile in the Merchant's system for later use. Now the Customer is authenticated successfully using 3DSecure, and last step is requesting authorisation to the issuer for the purchase. If the sale is approved by the issuer, the Credentials on File for the Customer are stored.
For this scenario the following parameters must be as follows: * inquiry = false * d4 > 0 * d22cp = INTERNET * capture = true
Request Body
[{"name"=>"d2", "value"=>"{{pan}}", "datatype"=>"string"}, {"name"=>"store_token", "value"=>"{{store_token}}", "datatype"=>"string"}, {"name"=>"daskm", "value"=>"{{merchant_card_token_credentials}}", "datatype"=>"string"}, {"name"=>"dask", "value"=>"{{system_card_token_credentials}}", "datatype"=>"string"}, {"name"=>"d3", "value"=>"{{processing_code_sale}}", "datatype"=>"string"}, {"name"=>"d4", "value"=>"{{amount_sale}}", "datatype"=>"string"}, {"name"=>"de4", "value"=>"{{currency_exponent}}", "datatype"=>"string"}, {"name"=>"d12", "value"=>"{{date_current}}", "datatype"=>"string"}, {"name"=>"d14", "value"=>"{{expiry_date}}", "datatype"=>"string"}, {"name"=>"d22cp", "value"=>"{{pos_env_internet}}", "datatype"=>"string"}, {"name"=>"d31", "value"=>"{{transaction_reference_credentials}}", "datatype"=>"string"}, {"name"=>"d49", "value"=>"{{currency_id_number}}", "datatype"=>"string"}, {"name"=>"capture", "value"=>"{{capture_false}}", "datatype"=>"string"}, {"name"=>"inquiry", "value"=>"{{inquiry_true}}", "datatype"=>"string"}, {"name"=>"cip", "value"=>"{{client_ip_address}}", "datatype"=>"string"}, {"name"=>"TXcavv", "value"=>"{{3DS_CAVV}}", "datatype"=>"string"}, {"name"=>"TransactionStatus", "value"=>"{{3DS_ECI}}", "datatype"=>"string"}, {"name"=>"PurchaseXID", "value"=>"{{3DS_XID}}", "datatype"=>"string"}, {"name"=>"DsTransId", "value"=>"{{3DS_TransID}}", "datatype"=>"string"}, {"name"=>"d2name", "value"=>"{{cardholder_name}}", "datatype"=>"string"}, {"name"=>"cof", "value"=>"{{cof_unscheduled}}", "datatype"=>"string"}, {"name"=>"rpnumber", "value"=>"{{cof_installments_rpnumber}}", "datatype"=>"string"}, {"name"=>"initiatedby", "value"=>"{{cof_initiatedby_cardholder}}", "datatype"=>"string"}, {"name"=>"mlang", "value"=>"{{language_errors}}", "datatype"=>"string"}, {"name"=>"clang", "value"=>"{{language_response}}", "datatype"=>"string"}, {"name"=>"user", "value"=>"{{user_name}}", "datatype"=>"string"}, {"name"=>"pwd", "value"=>"{{pass_word}}", "datatype"=>"string"}, {"name"=>"terminalId", "value"=>"{{terminalID}}", "datatype"=>"string"}, {"name"=>"d41", "value"=>"{{terminalNumber}}", "datatype"=>"string"}, {"name"=>"d42", "value"=>"{{merchantID}}", "datatype"=>"string"}, {"name"=>"separator", "value"=>"{{separator}}", "datatype"=>"string"}, {"name"=>"d39", "value"=>"000", "datatype"=>"string"}, {"name"=>"d39text", "value"=>"Approved", "datatype"=>"string"}, {"name"=>"error", "value"=>"10000", "datatype"=>"number"}, {"name"=>"errortext", "value"=>"Approved", "datatype"=>"string"}, {"name"=>"d38", "value"=>"165806", "datatype"=>"number"}, {"name"=>"d37", "value"=>"84000002", "datatype"=>"number"}, {"name"=>"d2brand", "value"=>"VISA", "datatype"=>"string"}, {"name"=>"d56", "value"=>"165343201", "datatype"=>"number"}, {"name"=>"transactionId", "value"=>"165343201", "datatype"=>"number"}, {"name"=>"correlationId", "value"=>"941172fb-8b6e-4088-9fd6-51ffcd8acf0f", "datatype"=>"string"}]
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string |
RESPONSES
status: OK
"d39=000\nuser=Rapyd\ndask=0000020046067405802\ndaskm=crt_4XPh2BTPJaaUUa03\nd3=000000\nd4=0\nde4=2\nd12=201203174850\nd14=2306\nd31=trf_FnZhzr0IVzO\nd38=174850\nterminalId=54321\nd41=90000360\nd42=8180001\nd49=840\nd56=165343801\ntransactionId=165343801\nd2brand=VISA\nd2dsp=xxxxxxxxxxxx7492\nerror=10000\nerrortext=Approved\nd39text=Approved\ncorrelationId=bab10dc4-b8a4-4945-9d5c-f8854c07088e"