topic Re: How to specify device fingerprint id in Cybersource REST API in cybersource APIs

How to specify device fingerprint id in Cybersource REST API

CarmosKarran — Tue, 04 Oct 2022 05:30:14 GMT

I'm trying to integrate CyberSource's REST API into a Django (Python) application. I'm following this GitHub example /echat spin example. It works like a charm but it is not clear to me from the example or from the documentation /echat random how to specify the device's fingerprint ID.

Here's a snippet of the request I'm sending in case it comes useful (note: this is just a method that lives inside a POPO):

def authorize_payment(self, card_token: str, total_amount: Money, customer: CustomerInformation = None,
                      merchant: MerchantInformation = None):
    try:
        request = {
            'payment_information': {
                # NOTE: REQUIRED.
                'card': None,
                'tokenized_card': None,
                'customer': {
                    'customer_id': card_token,
                },
            },
            'order_information': {
                'amount_details': {
                    'total_amount': str(total_amount.amount),
                    'currency': str(total_amount.currency),
                },
            },
        }

        if customer:
            request['order_information'].update({
                'bill_to': {
                    'first_name': customer.first_name,
                    'last_name': customer.last_name,
                    'company': customer.company,
                    'address1': customer.address1,
                    'address2': customer.address2,
                    'locality': customer.locality,
                    'country': customer.country,
                    'email': customer.email,
                    'phone_number': customer.phone_number,
                    'administrative_area': customer.administrative_area,
                    'postalCode': customer.zip_code,
                }
            })

        serialized_request = json.dumps(request)
        data, status, body = self._payment_api_client.create_payment(create_payment_request=serialized_request)

        return data.id
    except Exception as e:
        raise AuthorizePaymentError from e

Re: How to specify device fingerprint id in Cybersource REST API

rajvpate — Fri, 14 Oct 2022 16:59:47 GMT

Here is a sample of sending device information for the payment: https://github.com/CyberSource/cybersource-rest-samples-python/blob/master/samples/Payments/Payments/authorization-with-decision-manager-device-information.py

For fingerprint field information, you may refer to this:

Fingerprint Session Id

Field that contains the session ID that you send to Decision Manager to obtain the device fingerprint
information. The string can contain uppercase and lowercase letters, digits, hyphen (-), and
underscore (_). However, do not use the same uppercase and lowercase letters to indicate
different session IDs.

The session ID must be unique for each merchant ID. You can use any string that you are already
generating, such as an order number or web session ID.

The session ID must be unique for each page load, regardless of an individual’s web session ID.
If a user navigates to a profiled page and is assigned a web session, navigates away from the
profiled page, then navigates back to the profiled page, the generated session ID should be different
and unique. You may use a web session ID, but it is preferable to use an application GUID (Globally
Unique Identifier). This measure ensures that a unique ID is generated every time the page is
loaded, even if it is the same user reloading the page.

Re: How to specify device fingerprint id in Cybersource REST API

sdhar — Mon, 19 Aug 2024 23:08:46 GMT

@rajvpate thanks for the pointer. I find below text quoted in CyberSource developer guide:

"Important: The CyberSource generated device fingerprint ID overrides the merchant generated device fingerprint ID."

How do I get a handle of "CyberSource generated device fingerprint ID" instead of using one of our own?