Comment configurer les redirections

Présentation

Pour rediriger les utilisateurs vers une autre page après un paiement, configurez des redirections dans le Compte éditeur ou via API. Pour différents statuts de paiement (paiement réussi ou annulé), vous pouvez configurer les redirections suivantes :

• automatic — redirection avec un délai défini ;
• manuel — redirection après que l’utilisateur a cliqué sur le bouton de redirection.

Vous pouvez configurer simultanément des redirections automatiques et manuelles. L’utilisateur conservera la possibilité de cliquer sur le bouton de redirection pour revenir à l’application. Sinon, il sera automatiquement redirigé lorsque le délai défini sera écoulé.

• user_id — ID utilisateur ;
• foreigninvoice — ID de transaction passé dans le paramètre external_id ;
• invoice_id — ID de transaction ;
• status — statut de la transaction.

Exemple d’URL vers laquelle un utilisateur est redirigé : {Return URL}?user_id=[value]&foreignInvoice=[value]&invoice_id=[value]&status=done

Si l’utilisateur ferme l’onglet de l’interface avant de compléter le paiement, il est redirigé vers l’URL de redirection spécifiée au format suivant : {Return URL}?user_id=[value]&invoice_id=. Si l’interface de paiement s’ouvre avec Pay Station Embed, lors de la fermeture de l’interface de paiement, le widget se ferme et l’utilisateur retourne au jeu.

Configurer les redirections automatiques

Vous pouvez configurer les redirections automatiques :

Configurer les redirections automatiques dans le Compte éditeur

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Payments > Payment interface > General settings.
2. Accédez à la section Redirect policy.

3. Dans le champ Return URL, saisissez une adresse URL ou un chemin (un lien profond) vers lequel l’utilisateur est redirigé après un paiement. Pour optimiser l’expérience lors de l’ouverture de l’interface de paiement dans une application de jeu mobile, nous recommandons d’indiquer un lien profond comme URL de retour.
4. Dans la liste déroulante, sélectionnez Automatic redirect condition :
   • None — ne pas rediriger ;
   • Successful payment — rediriger lorsque le paiement est réussi ;
   • Successful or canceled payment — rediriger lorsque le paiement est réussi ou annulé ;
   • Any payment — rediriger pour tout statut de paiement.
5. Dans le champ Delay, saisissez le délai de redirection en secondes. Par défaut, il est réglé sur 0 seconde.
6. Pour configurer uniquement la redirection automatique sans bouton de redirection, dans la liste déroulante Manual redirect condition, sélectionnez None — do not redirect.
7. Appuyez sur Save changes.

Configurer les redirections automatiques via API

Pour configurer les redirections, passez les données suivantes dans l’appel API Créer un jeton :

Configurer les redirections manuelles

Vous pouvez configurer les redirections manuelles :

• dans le Compte éditeur ;
• via API.

Configurer les redirections manuelles dans le Compte éditeur

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Payments > Payment interface > General settings.
2. Accédez à la section Redirect policy.

3. Dans le champ Return URL, saisissez une adresse URL ou un chemin (un lien profond) vers lequel l’utilisateur est redirigé après un paiement. Pour optimiser l’expérience lors de l’ouverture de l’interface de paiement dans une application de jeu mobile, nous recommandons d’indiquer un lien profond comme URL de retour.
4. Pour configurer uniquement la redirection manuelle, dans la liste déroulante Automatic redirect condition, sélectionnez None — do not redirect.
5. Laissez le champ Delay vide.
6. Dans la liste déroulante Manual redirect condition, choisissez le statut de paiement pour lequel le bouton de redirection apparaît :
   • None — ne pas rediriger ;
   • Successful payment — rediriger lorsque le paiement est réussi ;
   • Successful or canceled payment — rediriger lorsque le paiement est réussi ou annulé ;
   • Any payment — rediriger pour tout statut de paiement.
7. Dans le champ Redirect button caption, saisissez le texte du bouton de redirection vers l’URL de retour.
8. Appuyez sur Save changes.

Configurer les redirections manuelles via API

Pour configurer les redirections, passez les données suivantes dans l’appel API Créer un jeton :

Exemple de configuration de redirections

Dans le Compte éditeur, vous avez configuré des redirections automatiques avec un délai de 3 secondes. Ce comportement s’applique tant à la version mobile qu’à la version bureau de l’interface de paiement. Les configurations définies dans le Compte éditeur sont les suivantes :

Si vous devez mettre à jour les paramètres pour ouvrir l’interface de paiement dans l’application mobile de votre jeu, notamment pour inclure le bouton de redirection et spécifier un lien profond comme URL de retour, mettez à jour les paramètres passés dans le jeton :

 1{
 2    "user": {
 3        "country": {
 4            "value": "US"
 5        },
 6        "id": {
 7            "value": "1234abCd"
 8        },
 9        "name": {
10            "value": "John Smith"
11        }
12    },
13    "settings": {
14        "currency": "USD",
15        "project_id": 123456,
16        "language": "en",
17        "return_url": "myapp://payment/successful",
18        "ui": {
19            "desktop": {
20                "header": {
21                    "visible_logo": true
22                }
23            }
24        },
25        "redirect_policy": {
26            "redirect_conditions": "any",
27            "redirect_button_caption": "Back to Store",
28            "manual_redirection_action": "redirect",
29            "status_for_manual_redirection": "any"
30        },
31        "external_id": "1a2b3c"
32    },
33    "custom_parameters": {
34        "timestamp": 1234512345123,
35        "sku": "testSKU",
36        "amount": "10"
37    },
38    "purchase": {
39        "virtual_items": {
40            "items": [
41                {
42                    "sku": "testSKU",
43                    "amount": 1
44                }
45            ]
46        }
47    }
48}