3RI - Requestor-Initiated Authentication

Ce guide est destiné aux marchands PCI-DSS utilisant notre API pour réaliser les authentifications.

La version 2.2 du protocole 3-D Secure introduit les authentifications initiées par le marchand ou"3DS Requestor initiated (3RI) authentications".

3RI is used in particular:

when paying an installment of a subscription
when paying a later installment of a payment in installments
for the MOTO payment

Le cas d'utilisation est déterminé par la valeur des champspaymentSource,useCaseandtransactionInitiator.

Voici quelques exemples d'utilisation de 3RI :

Use cases	Payment stages	useCase	paymentSource	transactionInitiator
Abonnement à fréquence et montants fixes	Payment of an nth installment	`RECURRING_FIXED_TOTALAMOUNT`	`EC`	`MERCHANT`
Abonnement à fréquence et/ou montants variables	Payment of an nth installment	`RECURRING_ VARIABLE_TOTAL_AMOUNT`	`EC`	`MERCHANT`
Payment in installments	Payment of an nth installment	`INSTALLMENT`	`EC`	`MERCHANT`
Payment by post	Payment	`PAYMENT`	`MAIL_ORDER`	n/a
Payment by phone	Payment	`PAYMENT`	`TELEPHONE_ORDER`	n/a

Operating principle

Le principe général s'applique aux authentifications "3RI".
A single call to the Web ServicePCI/Charge/Authenticateis all that's needed, and the merchant has no instructions to process or objectsdeviceto transmit.

List of fields relating to3RI:

name Description

amount Integer| Longueur : 1-12 |required

Montant de la transaction exprimé dans la plus petite fraction de la devise (par exemple : 30050 pour 30050 XPF).

currency

String| Longueur : 3 |required

Code de la devise selon la norme ISO 4217 alpha-3 (par exemple : "XPF" pour le franc CFP).

Possible values

Currency	ISO 4217 ENCODING	Fractional unit
Dollar australien (036)	`AUD`	2
Renminbi yuan chinois (156)	`CNY`	1
Franc Djibouti (262)	`DJF`	0
Euro (978)	`EUR`	2
Dollar de Fidji (242)	`FJD`	2
Livre Sterling (826)	`GBP`	2
Dollar de Hong Kong (344)	`HKD`	2
Yen (392)	`JPY`	0
Riel Cambodgien (116)	`KHR`	0
Kip laotien (418)	`LAK`	0
Dollar néo-zélandais (554)	`NZD`	2
Dollar des Îles Salomon (090)	`SBD`	2
Baht thailandais (764)	`THB`	2
Dollar des États-Unis (840)	`USD`	2
Vatu des Îles Vanuatu (548)	`VUV`	0
Franc CFP (953)	`XPF`	0

productType

énumération|Optional

Product type for which the transaction is made.

Possible values

value	Description
`ACCOUNT_FUNDING`	Wire transfer to an account.
`CHECK_ACCEPTANCE`	Acceptance testing.
`GOODS_OR_SERVICE_PURCHASE`	Achat de bien ou de service. Valeur utilisée par défaut.
`PREPAID_ACTIVATION_AND_LOAD`	Activation and loading of a prepaid card.
`QUASI_CASH_TRANSACTION`	Transactions en quasi-espèces (ex : chèque vacances, billet de loterie, etc.)

transactionCategory énumération|ignoré

Catégorie de la transaction.

paymentSource

énumération required

Source du paiement.

Possible values

value	Description
`EC`	E-commerce. Cas d'utilisation classique. Paiement initié par l'acheteur avec saisie des données de carte.
`MAIL_ORDER`	Paiement en vente à distance initié par le marchand par courrier ou e-mail.
`TELEPHONE_ORDER`	Paiement en vente à distance initié par le marchand par téléphone.

transactionInitiator

énumération|Optional

Initiateur de la transaction.

Possible values

</tbody>

value	Description
`CUSTOMER`	Transaction initiée par l'acheteur (CIT).
`MERCHANT`	Transaction initiée par le marchand (MIT).

useCase

énumération|required

Cas d'utilisation de la transaction.

Possible values

value	Description
`INSTALLMENT`	Payment in installments.
`MAINTAIN_CARD`	Utilisé par exemple pour confirmer l'état de la carte lors de paiements récurrents (abonnements ou paiements en plusieurs fois).
`OTHER_USE_CASE`	Autre cas d'utilisation.
`PAYMENT`	Immediate payment.
`RECURRING_VARIABLE_TOTALAMOUNT`	Abonnement à fréquence et/ou échéances variables.
`RECURRING_FIXED_TOTALAMOUNT`	Abonnement à fréquence et échéances fixes.
`REGISTER`	Enregistrement de la carte.
`SHIPMENT_MULTIPLE_AUTHORISATION`	Paiement à l'expédition avec autorisations multiples.
`SHIPMENT_SINGLE_AUTHORISATION`	Paiement à l'expédition avec autorisation simple.
`TOP_UP`	Rechargement de compte.
`TRUST_LIST_STATUS_CHECK`	Utilisé pour demander à l'emetteur si le marchand fait partie de la liste des bénéficiaires de confiance de l'acheteur. Dans ce cas, le marchand peut ensuite demander une exemption à l'authentification forte lors du paiement.
`VERIFY_ONLY`	Utilisé par exemple pour vérifier le solde de la carte lors de paiements récurrents (abonnements ou paiements en plusieurs fois).

customer

objet JSON|required

Objet contenant les informations sur l'acheteur.

Détails de l'objet

name Description

reference String| Longueur : 0-80 |Optional

Buyer ID on the merchant side.

email String| Longueur : 0-150 |Recommended

Adresse e-mail

accountDetails

objet JSON|Recommended

Objet contenant les informations du compte de l'acheteur sur le site marchand.

Détails de l'objet

name Description

authenticationMethod

énumération|Recommended

Méthode d'authentification de l'acheteur sur le site marchand.

Possible values

value	Description
`GUEST`	Pas d'authentification (invité).
`PERSONAL_CREDENTIALS`	Utilisation d'un compte créé sur le site marchand.
`FEDERATED_CREDENTIALS`	Utilisation de l'authentification fédérée.
`ISSUER_CREDENTIALS`	Utilisation d'identifiants fournis par l'émetteur.
`EXTERNAL_CREDENTIALS`	Authentification par un tiers.
`FIDO_CREDENTIALS`	Utilisation de l'authentification FIDO (Fast IDentity Online).

billingDetails

objet JSON|Optional

Objet contenant les informations sur l'acheteur.

Détails de l'objet

name Description

title

String| Longueur : 0-63 |Optional

Buyer's title.

Exemples de valeurs

category

énumération|Optional

Buyer type.

Possible values

value	Description
`PRIVATE`	Individual buyer type.
`COMPANY`	Client de type Société.

firstName String| Longueur : 0-63 |Optional

First name.

lastName String| Longueur : 0-63 |Optional

name.

phonenumber

String| Longueur : 0-32 |Optional

Numéro de téléphone fixe.

Exemples de valeurs

0123456789
+33123456789
0033123456789
(00.571) 638.14.00
40 41 42 42

streetNumber String| Longueur : 0-64 |Optional

Numéro de rue.

address String| Longueur : 0-255 |Optional

Billing address.

address2 String| Longueur : 0-255 |Optional

Informations complémentaires sur l'adresse.

district String| Longueur : 0-127 |Optional

District.

zipCode String| Longueur : 0-64 |Optional

Zip code.

city String| Longueur : 0-128 |Optional

City.

state String| Longueur : 0-127 |Optional

Région.

country

String| Longueur : 2 |Optional

Code pays (norme ISO 3166-1 alpha-2).

Exemples de valeurs

value	Description
`AT`	AUSTRIA
`BE`	BELGIQUE
`FR`	CORSICA
`CI`	IVORY COAST
`FR`	FRANCE
`GP`	GUADELOUPE
`MQ`	MARTINIQUE
`NC`	NEW CALEDONIA
`PM`	ST-PIERRE-ET-MIQUELON
`PF`	FRENCH POLYNESIA

language

String| Longueur : 2 |Optional

Code langue (norme ISO 639-1).

Exemples de valeurs

value	Description
`DE`	German (Germany)
`EN`	English (United Kingdom)
`EN`	English (United States)
`ZH`	Chinese (Traditional)
`ES`	Spanish (Spain)
`ES`	Spanish (Chile)
`FR`	French (France)
`IT`	Italian (Italy)
`JP`	Japanese (Japan)
`NL`	Dutch (the Netherlands)
`PL`	Polish (Poland)
`PT`	Portuguese (Brazil)
`PT`	Portuguese (Portugal)
`RU`	Russian (Russia)

cellPhonenumber

String| Longueur : 0-32 |Optional

Cell phone number.

Exemples de valeurs

0623456789
+33623456789
0033623456789
(+34) 824 65 43 21
87 77 12 34

identityCode String| Longueur : 0-150 |Optional

National identifier.

identityType

String| Longueur : 0-3 |Optional

ID type.

Possible values

Country	Type	Description
Argentina	`DNI`	Documento Nacional de Identidad.
Brasil	`CNPJ`	Cadastro Nacional da Pessoa Jurídica.
Brasil	`CPF`	Cadastro de Pessoas Físicas.
Colombia	`CC`	Cédula de ciudadania.
	`TI`	Tarjeta de Identidad.
	`CE`	Cédula de Extranjeria.
	`NI`	Número de Identificación Tributaria.
	`PS`	Pasaporte.
Peru	`DNI_PER`	Documento National de Identidad.
	`PAR`	Partida de Nacimiento.
	`PAS`	Pasaporte.
	`LMI`	Libreta Militar.
	`NAN`	Otro.

legalName String| Longueur : 0-100 |Optional

Raison Sociale.

shippingDetails

objet JSON|Optional

Objet contenant les informations de livraison.

Détails de l'objet

name Description

category

énumération|Optional

Buyer type.

Possible values

value	Description
`PRIVATE`	Individual buyer type.
`COMPANY`	Client de type Société.

firstName String| Longueur : 0-63 |Optional

First name.

lastName String| Longueur : 0-63 |Optional

name.

phonenumber

String| Longueur : 0-32 |Optional

Numéro de téléphone fixe.

Exemples de valeurs

0123456789
+33123456789
0033123456789
(00.571) 638.14.00
40 41 42 42

streetNumber String| Longueur : 0-64 |Optional

Numéro de rue.

address String| Longueur : 0-255 |Optional

Shipping address.

address2 String| Longueur : 0-255 |Optional

Informations complémentaires sur l'adresse de livraison.

district String| Longueur : 0-127 |Optional

District.

zipCode String| Longueur : 0-64 |Optional

Zip code.

city String| Longueur : 0-128 |Optional

City.

state String| Longueur : 0-127 |Optional

Région.


country

String| Longueur : 2 |Optional

Code pays (norme ISO 3166-1 alpha-2).

Exemples de valeurs

value	Description
`AT`	AUSTRIA
`BE`	BELGIQUE
`FR`	CORSICA
`CI`	IVORY COAST
`FR`	FRANCE
`GP`	GUADELOUPE
`MQ`	MARTINIQUE
`NC`	NEW CALEDONIA
`PM`	ST-PIERRE-ET-MIQUELON
`PF`	FRENCH POLYNESIA

deliveryCompanyName String| Longueur : 0-127 |Optional

Nom de la société de livraison.


shippingSpeed

énumération|Optional

Shipping delay.

Possible values

value	Description
`STANDARD`	Standard shipping.
`EXPRESS`	Express shipping (in less than 24h).
`PRIORITY`	-MISSED-ON-SOURCE-af02ef0e65a667ccdb3eff3d5ff103dbb07e5a15f98a2182543ef8822ab9be09.


shippingMethod

énumération|Optional

Shipping mode.

Possible values

value	Description
`RECLAIM_IN_SHOP`	Item pickup at the shop.
`RELAY_POINT`	Use of a third-party pickup network (Kiala, Alveol, etc.).
`RECLAIM_IN_STATION`	Pickup at an airport, a train station or a travel agency.
`PACKAGE_DELIVERY_COMPANY`	Shipping by the transporter (Colissimo, UPS, etc.).
`ETICKET`	Issue of an electronic ticket, online download of the product.

Valeurs réservées à un usage futur :

value	Description
`CARD_HOLDER_ADDRESS`	Delivery to the buyer.
`VERIFIED_ADDRESS`	Delivery to a verified address.
`NOT_VERIFIED_ADDRESS`	Delivery to a non-verified address.
`SHIP_TO_STORE`	In-store pickup.
`DIGITAL_GOOD`	Digital delivery.
`ETRAVEL_OR_ETICKET`	E-ticket.
`OTHER`	Autre.
`PICKUP_POINT`	Pickup point delivery.
`AUTOMATED_PICKUP_POINT`	Pickup at an automatic pickup point.

identityCode String| Longueur : 0-150 |Optional

National identifier.

legalName String| Longueur : 0-100 |Optional

Raison Sociale.

shoppingCart

objet JSON|Optional

Objet contenant les informations sur le panier.

Détails de l'objet

name Description

insuranceAmount Integer| Longueur : 1-12 |Optional

Montant de l'assurance pour l'ensemble de la commande, exprimé dans la plus petite unité de la devise (par exemple : 30050 pour 30050 XPF).

shippingAmount Integer| Longueur : 1-12 |Optional

Montant des frais de livraison pour l'ensemble de la commande, exprimé dans la plus petite unité de la devise (par exemple : 30050 pour 30050 XPF).

taxAmount Integer| Longueur : 1-12 |Optional

Montant des taxes pour l'ensemble de la commande, exprimé dans la plus petite unité de la devise (par exemple : 30050 pour 30050 XPF).

cartItemInfo

tableau |Optional

Liste d'objetsCustomer/ShoppingCartItemcontenant les informations sur chaque article du panier.

Détails de l'objet

name Description

productLabel String| Longueur : 0-255 |Optional

Product name.

productType

énumération|Optional

Type de produit.

Possible values

value	Description
`FOOD_AND_GROCERY`	Food and grocery.
`AUTOMOTIVE`	Cars / Moto.
`ENTERTAINMENT`	Entertainment / Culture.
`HOME_AND_GARDEN`	Home and gardening.
`HOME_APPLIANCE`	Équipement de la maison.
`AUCTION_AND_GROUP_BUYING`	Auctions and group purchasing.
`FLOWERS_AND_GIFTS`	Flowers and presents.
`COMPUTER_AND_SOFTWARE`	Computers and software.
`HEALTH_AND_BEAUTY`	Santé et beauté.
`SERVICE_FOR_INDIVIDUAL`	Services for individuals.
`SERVICE_FOR_BUSINESS`	Services for companies.
`SPORTS`	Sports.
`CLOTHING_AND_ACCESSORIES`	Clothes and accessories.
`TRAVEL`	Travel.
`HOME_AUDIO_PHOTO_VIDEO`	Sound, image and video.
`TELEPHONY`	Telephony.

productRef String| Longueur : 0-64 |Optional

Référence du produit.

productQty Integer| Longueur : 1-12 |Optional

Quantité du produit.

productAmount Integer| Longueur : 1-12 |Optional

Montant du produit, exprimé dans la plus petite unité de la devise (par exemple : 30050 pour 30050 XPF).

productVat

String| Longueur : 1-12 |Optional

Montant de la taxe sur le produit.

Type de valeurs possibles

integer
Pour exprimer un montant en centime appliqué sur le produit concerné.
Un nombre décimal
Pour exprimer un pourcentage appliqué sur le montant du produit concerné avec maximum 4 chiffres après la virgule.

La décimale est obligatoire pour exprimer un pourcentage. La décimale est marquée par le caractère ".".

previousAuthentication

objet JSON|required

Objet contenant les données de la dernière méthode d'authentification utilisée.

Détails de l'objet

name Description

dsTransID String| Longueur : 36 |required

Identifiant unique de la transaction généré par le Directory Server (par exemple : 4317fdc3-ad24-5443-8000-000000000891).

acsTransID String| Longueur : 36 |required

Identifiant de transaction unique généré par l'ACS (par exemple : d727ebfe-de4c-4682-85fa-e60ca00a9cff).

dateTime String| Longueur : 25 |required

Date et heure de l'authentification au format ISO 8601, dans le fuseau horaire UTC (par exemple : 2024-10-14T14:57:37+00:00).

effectiveAuthenticationType

énumération|required

Dernière méthode d'authentification utilisée.

Possible values

value	Description
`FRICTIONLESS`	Authentification sans interaction de l'acheteur.
`CHALLENGE`	Authentification avec interaction de l'acheteur.
`DATA_ONLY`	Authentification traitée par le DS sans interraction de l'acheteur.

device objet JSON|ignoré

Objet contenant les informations sur le navigateur.

paymentForm

objet JSON|required

Object containing the card data.

Détails de l'objet

name Description

networkPreference

énumération|required

Name of the preferred network recommended by the merchant.

Possible values

value	Description
`AMEX`	American Express network (SafeKey)
`CB`	Bank Card Network
`DINERS`	Diners network
`DISCOVER`	Discover network
`MASTERCARD`	MasterCard network
`OSB`	Network OSB
`VISA`	Visa network

accountType

énumération|Optional

Type de carte.

Possible values

value	Description
`CREDIT`	Credit card
`DEBIT`	Debit card

pan String| Longueur : 16-19 |required

Primary Account Number. Numéro de carte.

expiryMonth Integer| Longueur : 2 |required

Mois d'expiration sur 2 chiffres (par exemple : "09" pour septembre).

expiryYear Integer| Longueur : 2 |required

Année d'expiration sur 2 chiffres (par exemple : "28" pour 2028).

cardHolderName String| Longueur : 0-45 |Optional

Cardholder's first and last names.

installmentNumber Integer| Longueur : 3 |Optional

Number of installments.

protocolRequest

objet JSON|required

Objet contenant les informations sur le protocole d'authentification.

Détails de l'objet

name Description

name

énumération|required

Name of the protocol used by the cardholder authentication services.

Possible values

value	Description
`THREEDS`	3D Secure protocol
`OSB`	Protocol OTP OSB

version

String| Longueur : 1 |Optional

Version du protocole d'authentification à utiliser.

Possible values

value	Description
`1`	Protocol OTP OSB
`2`	Protocole 3D Secure 2

challengePreference énumération|ignoré

Permet de demander une authentication avec ou sans intéraction de l'acheteur.

merchant

objet JSON|required

Object containing information about the contract.

Détails de l'objet

name	Description
`mid`	String\| Longueur : 1-128 \|required Merchant ID. Numéro de contrat commerçant.
`tid`	String\| Longueur : 0-128 \|Optional Terminal ID. Identifiant du point de vente défini sur le contrat d'acceptation. This field is only used in Colombia for choosing between REDEBAN and CREDIBANCO.
`name`	String\| Longueur : 0-25 \|Optional Merchant's name.
`mcc`	String\| Longueur : 10 \|Optional Merchant Category Code. Code spécifique au DS émetteur décrivant le type d'activité, de produit ou de service du marchand.

recurring

objet JSON|Optional

Objet contenant les informations sur l'abonnement.

Détails de l'objet

name Description

expiryDate String| Longueur : 10 |Optional

Date d'expiration de l'abonnement (par exemple: 2025-12-31).

frequency

objet JSON| Longueur : 0-150 |Optional

Objet contenant les informations sur la fréquence de l'abonnement.

Détails de l'objet

name Description

value Integer| Longueur : 3 |Optional

Nombre minimal d'unités entre deux paiements (par exemple : 12). Voir champunit.

unit

énumération|Optional

Unité de fréquence de l'abonnement.

Possible values

value	Description
`DAY`	In days.
`MONTH`	In months.
`YEAR`	In years.

The response contains authentication data for future authorization requests.

Use cases

Recurring payments

Step 1 - Subscription to the plan (cardholder present)

Appelez le Web Service PCI/Charge/Authenticate pour authentifier l'acheteur :

Fréquence et montants fixes

{
  "amount":"9990",
  "currency":"XPF",
  "recurring":{
    "expiryDate": "2025-05-13",
    "frequency": {
        "unit": "DAY",
        "value": "30"
    }
  },
  "transactionCategory":"PAYMENT",
  "productType":"GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid":"9876357"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"28",
    "networkPreference":"VISA",
    "pan":"4970110000000021"
  },
  "device": {
    "acceptHeader":"text/html",
    "colorDepth":"32",
    "deviceType":"BROWSER",
    "ip":"69.89.31.226",
    "javaEnabled": true,
    "language":"FR",
    "screenHeight":"768",
    "screenWidth":"1258",
    "timeZoneOffset":"-120",
    "userAgent":"Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101"
  },
  "protocolRequest": {
    "name":"THREEDS",
    "version":"2",
    "challengePreference":"NO_PREFERENCE"
  }
}

Fréquence et/ou montants variables

{
  "amount":"9990",
  "currency":"XPF",
  "recurring":{
    "expiryDate": "2025-05-13",
    "frequency": {
        "unit": "DAY",
        "value": "30"
    }
  },
  "transactionCategory":"PAYMENT",
  "productType":"GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid":"9876357"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"28",
    "networkPreference":"VISA",
    "pan":"4970110000000021"
  },
  "device": {
    "acceptHeader":"text/html",
    "colorDepth":"32",
    "deviceType":"BROWSER",
    "ip":"69.89.31.226",
    "javaEnabled": true,
    "language":"FR",
    "screenHeight":"768",
    "screenWidth":"1258",
    "timeZoneOffset":"-120",
    "userAgent":"Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101"
  },
  "protocolRequest": {
    "name":"THREEDS",
    "version":"2",
    "challengePreference":"NO_PREFERENCE"
  }
}

L'objet recurring est requis pour définir la fréquence des échéances et la date de fin de l'abonnement.

Suivez le guide d'intégration du Web Service PCI/Charge/Authenticate pour le traitement des instructions et l'authentification du porteur.

Once the final result has been obtained, you can proceed with the authorization request.

Step 2 - Payment of installments (cardholder not present)

À chaque échéance, vous appelez le Web Service PCI/Charge/Authenticate pour demander une authentification 3RI.

L'objet recurring est requis pour définir la fréquence des échéances et la date de fin de l'abonnement.

Vous devez transmettre les données de l'authentification, obtenues lors de la souscription de l'abonnement, dans l'objet previousAuthentication :

Fréquence et montants fixes

{
  "amount":"9990",
  "currency":"XPF",
  "transactionInitiator": "MERCHANT",
  "useCase": "RECURRING_FIXED_TOTALAMOUNT",
  "recurring":{
    "expiryDate": "2025-05-13",
    "frequency": {
        "unit": "DAY",
        "value": "30"
    }
  },
  "productType":"GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid":"9876357"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"28",
    "networkPreference":"VISA",
    "pan":"4970110000000021"
  },
  "customer": {
    "previousAuthentication": {
        "dsTransID":"18e46ff7-b882-4102-9af4-aef9f40ee6a6",
        "acsTransID":"410d9fb4-8db1-483e-9a80-f94c3a79017e",
        "dateTime": "2024-10-09T06:37:22+00:00",
        "effectiveAuthenticationType": "CHALLENGE"
    }
  },
  "protocolRequest": {
    "name":"THREEDS",
    "version":"2"
  }
}

Fréquence et/ou montants variables

{
  "amount":"9990",
  "currency":"XPF",
  "transactionInitiator": "MERCHANT",
  "useCase": "RECURRING_VARIABLE_TOTAL_AMOUNT",
  "recurring":{
    "expiryDate": "2025-05-13",
    "frequency": {
        "unit": "DAY",
        "value": "30"
    }
  },
  "productType":"GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid":"9876357"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"28",
    "networkPreference":"VISA",
    "pan":"4970110000000021"
  },
  "customer": {
    "previousAuthentication": {
        "dsTransID":"18e46ff7-b882-4102-9af4-aef9f40ee6a6",
        "acsTransID":"410d9fb4-8db1-483e-9a80-f94c3a79017e",
        "dateTime": "2024-10-09T06:37:22+00:00",
        "effectiveAuthenticationType": "CHALLENGE"
    }
  },
  "protocolRequest": {
    "name":"THREEDS",
    "version":"2"
  }
}

The response contains the authentication data required for requesting authorization for the installment payment.

To help you, here is a table of correspondence between the data obtained in step 1 and the data required in step 2:

Sortie étape 1 (porteur présent)	Entrée étape 2 (porteur non présent)
`value.extension.dsTransID`	`customer.previousAuthentication.dsTransID`
`value.extension.acsTransID`	`customer.previousAuthentication.acsTransID`
`value.authenticationDateTime`	`customer.previousAuthentication.dateTime`
`value.authenticationType`	`customer.previousAuthentication.effectiveAuthenticationType`

Payments in installments

Step 1: Payment of the first installment (cardholder present)

Appelez le Web Service PCI/Charge/Authenticate pour authentifier l'acheteur. L'authentification doit être demandée pour le montant total des échéances.

{
  "amount":"12000",
  "currency":"XPF",
  "transactionCategory":"PAYMENT",
  "productType":"GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid":"9876357"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"28",
    "networkPreference":"VISA",
    "pan":"4970110000000021",
    "installmentNumber": "3"
  },
  "device": {
    "acceptHeader":"text/html",
    "colorDepth":"32",
    "deviceType":"BROWSER",
    "ip":"69.89.31.226",
    "javaEnabled": true,
    "language":"FR",
    "screenHeight":"768",
    "screenWidth":"1258",
    "timeZoneOffset":"-120",
    "userAgent":"Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101"
  },
  "protocolRequest": {
    "name":"THREEDS",
    "version":"2",
    "challengePreference":"NO_PREFERENCE"
  }
}

Dans cet exemple, le montant total des échéances est de 12000 XPF.

Le champ installmentNumber est requis pour spécifier le nombre d'échéances (ex : "3" pour un paiement en 3 fois).

Suivez le guide d'intégration du Web Service PCI/Charge/Authenticate pour le traitement des instructions et l'authentification du porteur.

Once the final result has been obtained, you can proceed with the authorization request for the amount of the first installment.

Step 2: Payment of a subsequent installment (cardholder not present)

À chaque échéance, appelez le Web Service PCI/Charge/Authenticate pour demander une authentification 3RI pour le montant de l'échéance.

Vous devez transmettre les données de l'authentification obtenues lors du paiement de la première échéance, dans l'objet previousAuthentication :

{
  "amount":"4000",
  "currency":"XPF",
  "transactionInitiator": "MERCHANT",
  "useCase": "INSTALLMENT",  
  "productType":"GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid":"9876357"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"28",
    "networkPreference":"VISA",
    "pan":"4970110000000021",
    "installmentNumber": "3"
  },
  "customer": {
    "previousAuthentication": {
        "dsTransID":"18e46ff7-b882-4102-9af4-aef9f40ee6a6",
        "acsTransID":"410d9fb4-8db1-483e-9a80-f94c3a79017e",
        "dateTime": "2024-10-09T06:37:22+00:00",
        "effectiveAuthenticationType": "CHALLENGE"
    }
  },
  "protocolRequest": {
    "name":"THREEDS",
    "version":"2"
  }
}

Dans cet exemple, l'authentification est demandée pour un montant de 4000 XPF.

The response contains the authentication data required for requesting authorization for the installment payment.

To help you, here is a table of correspondence between the data obtained in step 1 and the data required in step 2:

Sortie étape 1 (porteur présent)	Entrée étape 2 (porteur non présent)
`value.extension.dsTransID`	`customer.previousAuthentication.dsTransID`
`value.extension.acsTransID`	`customer.previousAuthentication.acsTransID`
`value.authenticationDateTime`	`customer.previousAuthentication.dateTime`
`value.authenticationType`	`customer.previousAuthentication.effectiveAuthenticationType`

MOTO payment

Appelez le Web Service PCI/Charge/Authenticate pour authentifier l'acheteur en précisant votre cas d'utilisation :

Payment by phone

{
  "amount":"9990",
  "currency":"XPF",
  "paymentSource": "TELEPHONE_ORDER",
  "useCase": "PAYMENT",
  "productType":"GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid":"9876357"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"28",
    "networkPreference":"VISA",
    "pan":"4970110000000021"
  },
  "protocolRequest": {
    "name":"THREEDS",
    "version":"2"
  }
}

Payment by post

{
  "amount":"9990",
  "currency":"XPF",
  "paymentSource": "MAIL_ORDER",
  "useCase": "PAYMENT",
  "productType":"GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid":"9876357"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"28",
    "networkPreference":"VISA",
    "pan":"4970110000000021"
  },
  "protocolRequest": {
    "name":"THREEDS",
    "version":"2"
  }
}

The response contains the authentication data required for the authorization request.

Categories

Tags

3RI - Requestor-Initiated Authentication

Operating principle

Use cases