Actions contre accusation (ancien)

Aperçu

Après avoir créé un charge, vous pouvez le gérer grâce à plusieurs actions clés pour maintenir votre système de gestion des commandes à jour. Ces actions prennent en charge divers flux de travail tels que le traitement des paiements, des remboursements et des annulations.

📘
Learn more about charge actions via our API Reference

Inclut des exemples de demande/réponse

Définitions d'objet-JSON

Attributs requis

Lire les frais

Avec l'API Read Charge, vous pouvez utiliser charge_id pour récupérer les données de la caisse et le statut d'un prélèvement particulier. La lecture de l'information relative aux frais est utile pour synchroniser votre système de gestion des commandes avec Affirm et pour s'assurer que les enregistrements sont à jour avant de prendre d'autres mesures.

Vous pouvez lire les frais uniques ou multiples. Notez que si vous ne spécifiez pas charge_id, la réponse comprend une liste des charges. Vous pouvez définir la pagination des résultats à l'aide des paramètres de requête limit, before et after .

// Read a single charge
curl https://sandbox.affirm.com/api/v2/charges/CHARGE_ID
     -X GET
     -u "public_key:private_key"
 
// Read multiple charges
curl https://sandbox.affirm.com/api/v2/charges/?limit=5&before=1234-ABCD
     -X GET
     -u "public_key:private_key"

Annuler

L’API Void Charge utilisée avec le charge_id annule ou supprime un prélèvement autorisé. Il est souvent utilisé lorsqu'un client annule une commande avant qu'elle ne soit exécutée. L'annulation d'une charge autorisée aura pour effet :

Annule définitivement un prêt
Avise l'utilisateur que la transaction a été annulée

curl https://sandbox.affirm.com/api/v2/charges/CHARGE_ID/void
     -X POST
     -u "(public_api_key):(private_api_key)"

remboursement

The Refund Charge API allows you to issue a refund for the original purchase amount or a partial amount, similar to refunding a credit card transaction. Affirm automatically calculates all interest and fees corresponding to the refunded amount. For partial refunds, you can refund any amount as long as there is a positive balance remaining on the loan. Refunds can also be processed directly through the Merchant Portal.

Note : Une fois qu'un prêt a été entièrement remboursé, il ne peut plus être rétabli.

curl https://sandbox.affirm.com/api/v2/charges/CHARGE_ID/refund \
     -X POST
     -u "(public_api_key):(private_api_key)"
     -H "Content-Type: application/json"
     -d '{"amount": 50000}'

Mettre à jour

Utilisez l’API Update Charge pour mettre à jour une charge avec de nouvelles informations sur la livraison ou la commande, comme shipping_confirmation, shipping_carrier, ou order_id. Les détails mis à jour sont reflétés dans les rapports de règlement, reliant les frais Affirm à vos identifiants de commande internes.

curl https://sandbox.affirm.com/api/v2/charges/CHARGE_ID/update
     -X POST
     -u "(public_api_key):(private_api_key)"
     -H "Content-Type: application/json"
     -d '{"order_id": "JLKM4321", "shipping_carrier": "USPS", "shipping_confirmation": "1Z23223", "shipping": {"name":{ "full": "John Doe"},"address": {"line1": "325 Pacific Ave", "state": "CA", "city": "San Francisco", "zipcode": "94111", "country": "USA"}}}'