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

KeyDatatypeRequiredDescription
Content-Typestring

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"