Yandex Wallet - Intégration

S’abonner




Comment configurer votre compte ?


Nous présentons les étapes à réaliser par le commerçant. Cette opération en deux étapes :

  1. Il remplit et soumet le formulaire ‘https://money.yandex.ru/joinups’ pour :
    1. s’enregistrer auprès de Yandex.Money ;
    2. créer un compte marchand sur le back-office Yandex.Money.
  2. Il se connecte sur le back-office Yandex.Money et configure :
    1. Le nom du marchand, c’est le nom de la boutique que voit l’acheteur sur les pages de paiement Yandex ;
    2. L’URL du site web, Il s’agit d’une adresse fixée par Payline et à fournir par le marchand. Cette URL doit également être fournie dans le formulaire d’inscription ;
    3. L’URL de retour d’autorisation accordée, URL sur laquelle est redirigé l’acheteur après un paiement accepté. Cette URL est surchargée par Payline à chaque autorisation, son contenu n’importe pas ;
    4. L’URL de retour d’autorisation refusée, URL sur laquelle est redirigé l’acheteur après un paiement refusé. Cette URL est surchargée par Payline à chaque autorisation, son contenu n’importe pas ;
    5. La check URL : URL technique sur laquelle Payline reçoit les demandes de vérification des commandes. Elle est définie par Payline et fournie par le marchand ;
    6. L’avisoURL : URL technique sur laquelle Payline reçoit les notifications de paiement effectué et les notifications de paiement annulé. Elle est définie par Payline et fournie par le marchand ;
    7. Le shopPassword : Il s’agit de la clé de scellement des messages envoyés par la plate-forme Yandex Payment Service. Sa valeur est choisie par le marchand, spécifiée dans le back-office Yandex.Money et recopiée dans chaque contrat.

Le marchand doit indiquer à Yandex Payment Solution que Payline met en œuvre le mode de scellement PKCS#7.

En retour la plate-forme Yandex Payment Solution retourne :

  • L’identifiant marchand (shopId) ;

  • L’identifiant du mode de paiement (scId).


Comment proposer le paiement Yandex à vos clients ?

Vous devez entrer en contact avec notre équipe support pour demander l'activation de ce moyen de paiement dans votre compte marchand.

Une fois le moyen de paiement activé, il vous suffit d'utiliser l'API WebPayment et les fonctions suivantes : 

  • doWebPayment ;
  • getWebPaymentDetails ;
  • getTransactionDetails ;
  • transactionsSearch;
  • doRefund, doCapture et doReset.

Les fonctionnalités de paiement disponibles sont :

  1. paiement à la commande : renseignez le champ payment.mode à CPT et payment.action à 101  et Payment currency = 643 (RUB);
  2. demande de remboursement d'une transaction : Utilisez la fonction doRefund() de l'API WebService.

Les autres fonctions de l'API ne sont pas disponibles pour ce moyen de paiement.

Les champs obligatoires

doWebPayment

Les contrôles :

  • Présence du customerID
  • Montant max. du moyen de paiement
getWebPaymentDetails

La référence de Facture YPS est ajoutée en private data avec le mot clé PAYLINE.INVOICE.ID.YPS

Pour les paiements par carte, Payline renvoie les informations carte : PAN masqué et date d’expiration dans les mêmes champs que pour les paiements CB

Comment réaliser des tests ?

Les codes de retour


Avec l'API WebPayment, Payline vous informe du résultat d'un paiement via Shortmessage des services : getWebPaymentDetails et getTransactionDetails.
Avec l'API DirectPayment, Payline vous informe du résultat de manière synchrone en réponse du doAuthorization
Lorsque le paiement est accepté, Payline renvoie le code retour à la valeur  00000.
Pour un paiement refusé, le code varie en fonction du motif de refus (Par exemple : 04xxx pour une suspicion de fraude).

Les codes spécifiques au moyen de paiement sont listés ici.


code retour ShorMessage Note
02020 REFUSED

Échéance de la temporisation de la page d’attente.

Fin de la session web de paiement.

Retour acheteur sur la shopFailURL.

00000 ACCEPTED Transaction acceptée.
02008 CANCELLED Retour acheteur sur la shopDefaultUrl.
02742 REFUSED Si aucun contrat ne satisfait aux différentes contraintes, Payline refuse la commande avec le code retour.
02102 ERROR

Acquirer server communication error.

Exemple de trame
<ns1:doWebPaymentRequest xmlns:ns2="http://obj.ws.payline.experian.com" xmlns:ns1="http://impl.ws.payline.experian.com" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/enve
lope/"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  <ns1:version>9</ns1:version>
 
<ns1:payment>
   
<ns2:amount>4400</ns2:amount>
   
<ns2:currency>643</ns2:currency>
   
<ns2:action>101</ns2:action>
   
<ns2:mode>CPT</ns2:mode>
   
<ns2:contractNumber>6666666</ns2:contractNumber>
   
<ns2:differedActionDate xsi:nil="true"/>
   
<ns2:method xsi:nil="true"/>
 
</ns1:payment>
 
<ns1:returnURL>http://demo.payline.com/~kitphp/examples/demos/web.php?e=getWebPaymentDetails</ns1:returnURL>
 
<ns1:cancelURL>http://demo.payline.com/~kitphp/examples/demos/web.php?e=getWebPaymentDetails</ns1:cancelURL>
 
<ns1:order>
   
<ns2:ref>PHP-1450282465</ns2:ref>
   
<ns2:origin>1</ns2:origin>
   
<ns2:country>FR</ns2:country>
   
<ns2:taxes>50</ns2:taxes>
   
<ns2:amount>1000</ns2:amount>
   
<ns2:currency>978</ns2:currency>
   
<ns2:date>16/12/2015 17:14</ns2:date>
   
<ns2:details>
     
<ns2:details>
       
<ns2:ref>reference1</ns2:ref>
       
<ns2:price>400</ns2:price>
       
<ns2:quantity>1</ns2:quantity>
       
<ns2:comment>Comment for item 1</ns2:comment>
       
<ns2:category>10</ns2:category>
       
<ns2:brand>br1</ns2:brand>
       
<ns2:subcategory1 xsi:nil="true"/>
       
<ns2:subcategory2 xsi:nil="true"/>
       
<ns2:additionalData xsi:nil="true"/>
       
<ns2:taxRate>5</ns2:taxRate>
     
</ns2:details>
     
<ns2:details>
       
<ns2:ref>reference2</ns2:ref>
       
<ns2:price>600</ns2:price>
       
<ns2:quantity>1</ns2:quantity>
       
<ns2:comment>Comment for item 2</ns2:comment>
       
<ns2:category>10</ns2:category>
       
<ns2:brand>br2</ns2:brand>
       
<ns2:subcategory1 xsi:nil="true"/>
       
<ns2:subcategory2 xsi:nil="true"/>
       
<ns2:additionalData xsi:nil="true"/>
       
<ns2:taxRate>5</ns2:taxRate>
     
</ns2:details>
   
</ns2:details>
   
<ns2:deliveryTime>1</ns2:deliveryTime>
   
<ns2:deliveryMode>4</ns2:deliveryMode>
   
<ns2:deliveryExpectedDate>20/12/2015</ns2:deliveryExpectedDate>
   
<ns2:deliveryExpectedDelay>4</ns2:deliveryExpectedDelay>
 
</ns1:order>
 
<ns1:notificationURL>http://demo.payline.com/~kitphp/examples/demos/web.php?e=getWebPaymentDetails</ns1:notificationURL>
 
<ns1:selectedContractList>
   
<ns2:selectedContract>6666666</ns2:selectedContract>
   
<ns2:selectedContract>1111111</ns2:selectedContract>
 
</ns1:selectedContractList>
 
<ns1:secondSelectedContractList xsi:nil="true"/>
 
<ns1:privateDataList>
   
<ns2:privateData>
     
<ns2:key>key 1</ns2:key>
     
<ns2:value>value 1</ns2:value>
   
</ns2:privateData>
   
<ns2:privateData>
     
<ns2:key>key 3</ns2:key>
     
<ns2:value>value 3</ns2:value>
   
</ns2:privateData>
   
<ns2:privateData>
     
<ns2:key>key 2</ns2:key>
     
<ns2:value>value 2</ns2:value>
   
</ns2:privateData>
   
<ns2:privateData>
     
<ns2:key>key 4</ns2:key>
     
<ns2:value>value 4</ns2:value>
   
</ns2:privateData>
   
<ns2:privateData>
     
<ns2:key>key 5</ns2:key>
     
<ns2:value>value 5</ns2:value>
   
</ns2:privateData>
   
<ns2:privateData>
     
<ns2:key>key 7</ns2:key>
     
<ns2:value>value 7</ns2:value>
   
</ns2:privateData>
   
<ns2:privateData>
     
<ns2:key>key 6</ns2:key>
     
<ns2:value>value 6</ns2:value>
   
</ns2:privateData>
   
<ns2:privateData>
     
<ns2:key>key 8</ns2:key>
     
<ns2:value>value 8</ns2:value>
   
</ns2:privateData>
 
</ns1:privateDataList>
 
<ns1:languageCode xsi:nil="true"/>
 
<ns1:customPaymentPageCode xsi:nil="true"/>
 
<ns1:buyer>
   
<ns2:title>M</ns2:title>
   
<ns2:lastName>garin</ns2:lastName>
   
<ns2:firstName>rudy</ns2:firstName>
   
<ns2:email>pepito@gmail.com</ns2:email>
   
<ns2:shippingAdress>
     
<ns2:title>Mme</ns2:title>
     
<ns2:name>Home</ns2:name>
     
<ns2:firstName>Approved2</ns2:firstName>
     
<ns2:lastName>Testperson-de2</ns2:lastName>
     
<ns2:street1>Hellersbergstrabe 14</ns2:street1>
     
<ns2:street2 xsi:nil="true"/>
     
<ns2:cityName>Neuss</ns2:cityName>
     
<ns2:zipCode>41460</ns2:zipCode>
     
<ns2:country>DE</ns2:country>
     
<ns2:phone xsi:nil="true"/>
     
<ns2:state>BY</ns2:state>
     
<ns2:county xsi:nil="true"/>
     
<ns2:phoneType>0</ns2:phoneType>
   
</ns2:shippingAdress>
   
<ns2:billingAddress>
     
<ns2:title xsi:nil="true"/>
     
<ns2:name xsi:nil="true"/>
     
<ns2:firstName xsi:nil="true"/>
     
<ns2:lastName xsi:nil="true"/>
     
<ns2:street1 xsi:nil="true"/>
     
<ns2:street2 xsi:nil="true"/>
     
<ns2:cityName xsi:nil="true"/>
     
<ns2:zipCode xsi:nil="true"/>
     
<ns2:country xsi:nil="true"/>
     
<ns2:phone xsi:nil="true"/>
     
<ns2:state xsi:nil="true"/>
     
<ns2:county xsi:nil="true"/>
     
<ns2:phoneType>0</ns2:phoneType>
   
</ns2:billingAddress>
   
<ns2:accountCreateDate xsi:nil="true"/>
   
<ns2:accountAverageAmount xsi:nil="true"/>
   
<ns2:accountOrderCount xsi:nil="true"/>
   
<ns2:walletId xsi:nil="true"/>
   
<ns2:walletDisplayed>none</ns2:walletDisplayed>
   
<ns2:walletSecured xsi:nil="true"/>
   
<ns2:walletCardInd xsi:nil="true"/>
   
<ns2:ip xsi:nil="true"/>
   
<ns2:mobilePhone xsi:nil="true"/>
   
<ns2:customerId>PEP02</ns2:customerId>
   
<ns2:legalStatus xsi:nil="true"/>
   
<ns2:legalDocument xsi:nil="true"/>
   
<ns2:birthDate xsi:nil="true"/>
   
<ns2:fingerprintID xsi:nil="true"/>
 
</ns1:buyer>
 
<ns1:owner xsi:nil="true"/>
 
<ns1:securityMode xsi:nil="true"/>
 
<ns1:recurring xsi:nil="true"/>
 
<ns1:customPaymentTemplateURL xsi:nil="true"/>
 
<ns1:contractNumberWalletList xsi:nil="true"/>
</ns1:doWebPaymentRequest>


Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 0 sur 0
Vous avez d’autres questions ? Envoyer une demande

Commentaires

Réalisé par Zendesk