Mise à niveau des appareils

Aperçu

Pour les clients qui utilisent Affirm pour financer un smartphone, vous pouvez mettre en place une intégration dans votre système de facturation qui permet aux consommateurs de passer à un nouvel appareil. Lorsqu'un client paie et atteint un certain solde de prêt sur son téléphone actuel, il peut l'échanger et passer à un nouveau téléphone.

Démarrage rapide

Permettre à vos clients de mettre à jour leurs téléphones intelligents est facile avec Affirm. Si vous disposez déjà d'une intégration avec notre Direct API, il vous suffit d'effectuer les opérations suivantes pour permettre à vos clients d'effectuer des mises à niveau d'appareils :

1. Utilisez le point de terminaison Lire l'avancement des frais pour récupérer les données du client sur son prêt existant et déterminer l'admissibilité en fonction du montant qu'il a payé pour le prêt.
2. Lancez une nouvelle facturation pour le téléphone mis à niveau.
3. Utilisez le point de terminaison Refund charge pour créditer le solde restant de la reprise. 

La suite de ce démarrage rapide décrit en détails la configuration des mises à niveau des appareils.

1. Récupérer les détails de l'état d'avancement des frais

Use the GET /api/v2/charges/{charges_ari}/progress endpoint to retrieve the customer's existing loan details.

demande

curl -X GET \
  https://sandbox.affirm.com/api/v2/charges/ALE5-YGRS/progress
  -u "public_key:private_key"

Réponse

Lors de la récupération des détails du prêt du client, la réponse comprend les renseignements suivants :

{
"loan_id": "ALE5-YGRS",
"total_loan_value": 75000,
"down_payment": 10000,
"paid_principal": 5000,
"paid_interest": 2500
}

2. Initier un nouveau prêt

Utilisez notre site Affirm Direct pour initier un prêt pour le nouvel appareil du client.

3. Valeur de crédit du téléphone repris

Si le client a droit à une mise à niveau et choisit d'échanger son téléphone, vous devrez utiliser l'API Remboursement pour créditer la valeur du téléphone. Utilisez le paramètre amount pour spécifier le montant (en cents) à créditer au client. Si ce paramètre est manquant ou nul, la totalité du solde du prêt sera remboursée.

demande

curl -X POST \
  https://sandbox.affirm.com/api/v2/charges/ALE5-YGRS/refund \
  -H 'Content-Type: application/json' \
  -u "public_key:private_key"
  -d '{"amount": 50000}'

Réponse

{
"created": "2019-08-03T19:00:10Z"
"fee_refunded": 0, 
"Amount": 50000,
"type": "refund",
"id": "QWA49MWUCA29SBVQ",
"transaction_id": "r86zdlcHOMBcaiVJK"
}