Configuration des 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 votre Compte éditeur et accédez à Pay Station > Settings > Redirect policy.

2. Dans le champ Return URL, saisissez une adresse URL ou un chemin (un lien profond) vers lequel l'utilisateur est redirigé après le paiement. Pour améliorer l'expérience utilisateur lorsque l'utilisateur ouvre l'interface de paiement dans une application de jeu mobile, nous recommandons de spécifier un lien profond en tant qu'URL de retour.
3. Dans la liste déroulante, choisissez Automatic redirect condition :
   • None — Aucune redirection ;
   • Successful payment — redirection lorsque le paiement est réussi ;
   • Successful or canceled payment — redirection lorsque le paiement est réussi ou annulé ;
   • Any payment — redirection peu importe le statut du paiement.
4. Dans le champ Delay, indiquez le délai d'attente avant redirection en secondes. Par défaut, la redirection est activée en 0 seconde.
5. Si vous souhaitez configurer uniquement la redirection automatique sans ajouter de bouton de redirection, dans la liste déroulante Manual redirect condition, choisissez None — do not redirect.
6. Cliquez sur Save.

Configurer les redirections automatiques via API

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

• settings.return_url — adresse URL ou chemin (lien profond) vers lequel l'utilisateur est redirigé après le paiement. Pour améliorer l'expérience utilisateur lorsque l'utilisateur ouvre l'interface de paiement dans une application de jeu mobile, nous recommandons de spécifier un lien profond en tant qu'URL de retour.
• settings.redirect_policy.redirect_conditions — conditions de redirection :
  • none — aucune redirection ;
  • successful — redirection lorsque le paiement est réussi ;
  • successful_or_canceled — redirection lorsque le paiement est réussi ou annulé ;
  • any — redirection peu importe le statut du paiement.
• settings.redirect_policy.delay — délai d'attente en secondes lorsque la redirection vers l'URL passée dans le paramètre settings.return_url est activée. Par défaut, la redirection est activée en 0 seconde.

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 votre Compte éditeur et accédez à Pay Station > Settings > Redirect policy.

1. Dans le champ Return URL, saisissez une adresse URL ou un chemin (un lien profond) vers lequel l'utilisateur est redirigé après le paiement. Pour améliorer l'expérience utilisateur lorsque l'utilisateur ouvre l'interface de paiement dans une application de jeu mobile, nous recommandons de spécifier un lien profond en tant qu'URL de retour.
2. Si vous souhaitez configurer uniquement la redirection manuelle, dans la liste déroulante Automatic redirect condition, choisissez None — aucune redirection ;.
3. Laissez le champ Delay vide.
4. Dans la liste déroulante Manual redirect condition, choisissez un statut de paiement lorsque le bouton de redirection apparaît :
   • None — aucune redirection ;
   • Successful payment — redirection lorsque le paiement est réussi ;
   • Successful or canceled payment — redirection lorsque le paiement est réussi ou annulé ;
   • Any payment — redirection peu importe le statut de paiement.
5. Dans le champ Redirect button caption, saisissez le texte du bouton qui redirigera l'utilisateur vers l'URL de retour.
6. Cliquez sur Save.

Configurer les redirections manuelles via API

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

• settings.return_url — adresse URL ou chemin (lien profond) vers lequel l'utilisateur est redirigé après un paiement. Pour améliorer l'expérience utilisateur lorsque l'utilisateur ouvre l'interface de paiement dans une application de jeu mobile, nous recommandons de spécifier un lien profond en tant qu'URL de retour.
• settings.redirect_policy.manual_redirection_action — comportement de l'interface de paiement déclenché par l'utilisateur en cliquant sur le bouton de fermeture ou le bouton de retour :
  • redirect (par défaut) — l'utilisateur est redirigé vers l'URL de retour ;
  • postmessage — en cliquant sur l'icône de fermeture, l'envoi de l'événement close-widget est initié, et en cliquant sur le bouton de retour, l'événement return est déclenché. Dans ce cas, l'utilisateur n'est pas redirigé vers l'URL de retour. Vous devez configurer le traitement des événements de fermeture de l'interface de paiement ou de redirection. Ce paramètre n'est disponible que lors de l'utilisation de l'API.
• settings.redirect_policy.redirect_button_caption — texte du bouton qui redirigera l'utilisateur vers l'URL de retour.
• settings.redirect_policy.status_for_manual_redirection — statut de paiement auquel le bouton de redirection apparaît :
  • none — aucune redirection ;
  • successful — redirection lorsque le paiement est réussi ;
  • successful_or_canceled — redirection lorsque le paiement est réussi ou annulé ;
  • any — redirection peu importe le statut de paiement.

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 :

{
    "user": {
        "country": {
            "value": "US"
        },
        "id": {
            "value": "1234abCd"
        },
        "name": {
            "value": "John Smith"
        }
    },
    "settings": {
        "currency": "USD",
        "project_id": 123456,
        "language": "en",
        "return_url": "myapp://payment/successful",
        "ui": {
            "desktop": {
                "header": {
                    "visible_logo": true
                }
            }
        },
        "redirect_policy": {
            "redirect_conditions": "any",
            "redirect_button_caption": "Back to Store",
            "manual_redirection_action": "redirect",
            "status_for_manual_redirection": "any"
        },
        "external_id": "1a2b3c"
    },
    "custom_parameters": {
        "timestamp": 1234512345123,
        "sku": "testSKU",
        "amount": "10"
    },
    "purchase": {
        "virtual_items": {
            "items": [
                {
                    "sku": "testSKU",
                    "amount": 1
                }
            ]
        }
    }
}