> Validity of the offer (in hours) (numeric) > Source that has provided the DCC rates > Merchant's unique order reference (alphanumeric) If the DCC rates were successfully obtained, the XML will have the following format: The response of the API call is always an XML structured document containing all information needed to proceed to the second stage of the transaction process. MySecretSig1875!?PSWD=MySecretPswd51MySecretSig1875!?USERID=MyAPIUserMySecretSig1875!? Note: If you want to provide both the BIN and the CONVCCY parameter, both should be hashed, even though only the BIN will be taken into account in the process. MySecretSig1875!?USERID=MyAPIUserMySecretSig1875!? ORDERID=order00001MySecretSig1875!?PSPID=MyPSPIDMySecretSig1875!?PSWD=MySecretPswd51 SHA passphrase (in Technical information):ĪMOUNT=150MySecretSig1875!?BIN=411111MySecretSig1875!?CURRENCY=EURMySecretSig1875!? Even though the principle is the same as for the pre-payment SHA, they are not to be confused these are two separate processes. The same order reference should be used if several DCC rate queries are done for the same transaction.īelow we display how the SHA calculation for the DCC request works. It is important that this reference will be used later on again when processing the actual transaction, since the DCC rates will be attached to this specific order. The order reference provided with the ORDERID parameter is a mandatory parameter that must be unique.In any case, we strongly recommend you to use the BIN rather than the CONVCCY parameter. This means that if both are provided, the BIN will have the priority over the CONVCCY, and the new currency is determined based on this BIN. The CONVCCY is mandatory if no BIN was provided, and is ignored otherwise. The BIN is mandatory if no CONVCCY is provided. Either the BIN or the CONVCCY parameter is mandatory, as it needs to be determined what currency the amount should be converted into.If any of these fields are not properly provided, an error will occur. The currency the amount should be converted toĭigest (hashed string) to authenticate the data The first digits (BIN number) of the customer’s card The original amount to be converted (amount x 100) To receive a valid DCC rate response, the following parameters must be sent to the DCC API: Field / Format The following URLs are used to call the Worldline DCC API: you can't request DCC rates for a VISA credit card if you don't support VISA payments or if you don't support DCC payments for this card type. You should be able to support the card brand for which you request the DCC rates e.g.The DCC option needs to be enabled in your account.The DirectLink (server-to-server) option needs to be enabled in your account.There are a few conditions if you want to use the DCC API: This API will return an XML document containing the DCC values that Worldline retrieved from the DCC provider. If you want to retrieve the DCC offer for the card number used by the customer, you must use the DCC API. DCC details request via Worldline DCC API You request the payment with a general DirectLink call, including some extra parameters (to provide the chosen DCC details obtained earlier on)Ģ.You request the DCC details, based on the customer's card BIN number.With DirectLink, the DCC process is split up in two stages: It's an option that can be enabled on your request. Electronic Dynamic Currency Conversion (DCC) enables your customers to choose between their preferred currency and your default currency.
0 Comments
Leave a Reply. |