3DSecure - Freedom Pay

When using this method, 3ds is required, therefore it is necessary to make a request to the ACS server of the card issuer bank

3D Secure (3DS) is an authentication technology to protect against unauthorized use of cards. It allows for verifying the cardholder’s identity before the payment is processed

The authentication process works as follows: after entering the card details, the issuer’s website opens, prompting the cardholder to enter a password or secret code. The code is usually sent via SMS. If the code is entered correctly, the payment is authorized; if not, the transaction is declined

3D Secure is available only for cards issued by banks that support this technology. Payments without 3D Secure are considered less secure

Request

Body Params multipart/form-data

pg_merchant_id

integer

required

Merchant ID in {{project}}
Issued upon connection

pg_payment_id

integer

required

Transaction ID

pg_md

string

required

Parameter from the response
ACS server of the issuer.

pg_pares

string

required

Parameter from response
ACS server of the issuer

pg_salt

string

required

Random string consisting of arbitrary numbers and Latin letters

pg_sig

string

required

Request signature

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/xml

Body

pg_payment_id

integer

required

Transaction ID

pg_status

string

required

Request status

pg_auth_code

string

required

Payment authorization code from the bank

pg_salt

string

required

Random string

pg_sig

string

required

Digital signature of the request

pg_card_id

integer

optional

ID of the stored card for future payments (if card storage parameters pg_save_card and pg_user_id were specified). Deprecated

pg_card_token

string

optional

Saved card token for next payment. (if card storage parameters pg_save_card and pg_user_id were specified)

Example

<?xml version="1.0" encoding="utf-8"?>
<response>
    <pg_payment_id>7999007771</pg_payment_id>
    <pg_status>ok</pg_status>
    <pg_auth_code>243412</pg_auth_code>
    <pg_reference>241107063029</pg_reference>
    <pg_datetime>2024-11-07T06:30:29+00:00</pg_datetime>
    <pg_salt>Lc9M2TKR79VVNEc4</pg_salt>
    <pg_sig>91c6f70ea9e20db854a61b0c90c6ae9c</pg_sig>
</response>

🟢200Error

🟢200Invalid Signature