Systempay - Paiement avec carte enregistrée (one-click)

Ressources

Accès aux paiements avec carte enregistrée :

- Accès aux paiements d’un utilisateur connecté
/api/payins/storedcardpayments

Accès aux paiements d’un utilisateur appartenant à l’application tierce connectée.
/api/users/appUserId/payins/storedcardpayments

1.StoredCardPayment

Contient les informations d’un paiement avec carte enregistrée

Propriété Type Exemple Description
Id Long 22 Id du paiement
OrderId String "123" Identifiant du paiement chez l’application tierce
AccountId SubAccountRef Précise le sous-compte qui effectue le paiement.
Si non précisé, c’est le compte principal qui est utilisé.
Card CardRef Carte bancaire utilisée
Amount Long 1020 Montant du paiement (en centimes)
Fee Fee Commission
OperationDate DateTime 2013-09-10T 15:49:58 .791121+02:00 Date du paiement
IsMine Bool Vrai si le titulaire du compte est également le titulaire de la carte bancaire (il s’agit d’un chargement du compte et non pas d’un paiement)
Status Int 1 Statut du paiement
0 = En attente
1 = Réalisé
2 = Remboursé
3 = Échoué
4 = En attente de validation
5 = Annulé
6 = En attente de remise

2.CardRef

Contient les informations d’une carte bancaire

Propriété Type Exemple Description
AppCardId String "card123" AppCardId de la carte à utiliser
Href Uri Uri vers le détail de la carte bancaire

3.SubAccountRef

Cet objet permet d’identifier les comptes entre lesquels les opérations s’effectuent

Propriété Type Exemple Description
Id Long 98 Identifiant du compte.
AppAccountId String "123" Identifiant du compte fournit par l’appli tierce.
DisplayName String "Jean Dupont" Nom d’affichage du compte
Href Uri "/api/accounts/123" Uri vers le détail du compte

4.Fee

L’objet Fee définit les commissions qui seront appliquées

Propriété Type Exemple Description
Amount long 150 Montant HT de la commission (en centimes)
VAT double 20 Pourcentage de la commission (en pourcentage)
AmountWithVAT long 180 Montant TTC de la commission (en centimes)
Status Int 1 Statut de la commission
0 = En attente
1 = Réalisé
2 = Remboursé
3 = Échoué
5 = Annulé

Créer un paiement avec une carte enregistrée (one-click)

Pour créer un paiement avec une carte déjà enregistrée veuillez vous référer à l’exemple présent en marge de droite de cette page.

Cas d’erreurs :

Code HTTP Code erreur Explication
400 195 Carte bancaire introuvable
400 111 Votre compte est incorrect ou incomplet
400 500 Votre compte est en opposition
400 149 Plafond de transaction atteint

Récupérer la liste des paiements

Pour récupérer la liste des paiements effectués avec une carte enregistrée, veuillez vous référer à l’exemple présent en marge de droite de cette page.

Récupérer un paiement

Pour récupérer un paiement effectué avec une carte enregistrée, veuillez vous référer à l’exemple présent en marge de droite de cette page.

Cas d’erreurs :

Code HTTP Code erreur Explication
404 356 Opération introuvable

Rembourser un paiement

Pour rembourser un paiement veuillez vous référer à l’exemple présent en marge de droite de cette page.

Cas d’erreurs :

Code HTTP Code erreur Explication
404 356 Opération introuvable
400 706 Le montant du remboursement dépasse le montant de l’opération originale