Paiement de la facture

{
  "urlOk": "https://host/ok",
  "urlFailed": "https://host/failed"
}

Pour payer la facture le client doit faire une demande en y indiquant un URL de redirection suite a un paiement reussit urlOk et un URL de redirection suite a un paiement echoue. L'identifiant de la facture doit etre indique dans le chemin de la requete HTTP /prosper-bill/api/invoice/payment/{id} ou id et la valeur du champ id dans la facture.

POST /prosper-bill/api/invoice/payment/{identifiant de la facture} HTTP/1.1
Cookie: refresh_token=<Token de rafraichissement>; access_token=<Token d'acces>
Content-Type: application/json

{
  "urlOk": "https://host/ok",
  "urlFailed": "https://host/failed"
}

Suite a une demande reussit le serveur repond avec l'URL de la page de paiement de la facture, le client doit donc rediriger l'utilisateur vers cette page.

{
  "paymentURL": "https://prosperus.tech/prosper-bill/payment/1"
}

Suite a la fin du paiement le service ProsperUS peut indiquer l'etat du paiement sur un webhook configurable.

{
  "invoiceID": 1,
  "orderID": 1,
  "paymentGateway": "PAYMEE",
  "success": true
}

Le champ invoiceID indique l'identifiant de la facture, le champ orderID est l'identifiant du paiement, paymentGateway indique le moyen de paiement que l'utilisateur a choise et le champ success indique est true si le paiement est reussi et false sinon.

actor Bob
participant Topnet
participant ProsperUS
participant "Gateway de paiement" as Gateway

Bob       ->  Topnet:    Demande de paiement
activate Topnet

Topnet    ->  ProsperUS: Creation de facture
activate ProsperUS

ProsperUS --> Topnet:    Nouvelle facture
deactivate ProsperUS

Topnet    ->  ProsperUS: Creation de paiement
activate ProsperUS
ProsperUS --> Topnet:    URL de redirection
deactivate ProsperUS

Topnet    --> Bob:       Redirection
deactivate Topnet

Bob       ->  ProsperUS: Paiement
activate ProsperUS
ProsperUS ->  Gateway:   Paiement
activate Gateway
Gateway   --> ProsperUS: Resultat du paiement
deactivate Gateway
ProsperUS ->  ProsperUS: Traitement de la facture
ProsperUS ->  Topnet:    Indication de l'etat du paiement
ProsperUS --> Bob:       Redirection
deactivate ProsperUS