Liens de paiement

Un lien de paiement permet de generer une URL publique que vous pouvez envoyer a un client par email, SMS, WhatsApp ou afficher dans votre application.

Montants et unités

Envoyez amount en valeur réelle par défaut : 4.01 pour 4,01 USD/EUR. Les clients API qui envoient déjà des centimes peuvent préciser amount_unit: "MINOR" à la racine du corps JSON, au même niveau que amount et currency, et non dans metadata. Les réponses publiques reviennent en valeur réelle même si la requête utilise MINOR. Consultez les montants et devises.

Cas d’usage

paiement d’une facture;
paiement hors panier;
recouvrement client;
paiement manuel depuis un backoffice;
paiement recurrent declenche par une souscription.

Creer un lien

curl -X POST "https://api.mysoleas.com/payment-links" \
  -H "x-sp-auth-token: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 15000,
    "currency": "XAF",
    "provider": "mtn_cmr",
    "channel": "PROVIDER",
    "feeBearer": "CUSTOMER",
    "title": "Facture FAC-2026-001",
    "description": "Paiement de la facture FAC-2026-001",
    "expires_at": "2026-08-30T23:59:59+01:00",
    "max_usage": 1,
    "metadata": {
      "invoice_reference": "FAC-2026-001"
    }
  }'

La reponse contient payment_url. Redirigez le client vers cette URL ou partagez-la.

{
  "reference": "PLK-20260728-000001",
  "short_code": "A1B2C3D4",
  "payment_url": "https://pay.soleaspay.com/link/A1B2C3D4",
  "status": "ACTIVE",
  "amount": 15000,
  "currency": "XAF"
}

Gerer le montant

Le champ amount est optionnel a la creation. Si vous ne le fixez pas, le payeur peut fournir le montant au moment du paiement, selon les regles de votre integration. Si max_usage vaut 1, le lien doit etre considere comme usage unique.

Gerer les frais

Un lien de paiement peut fixer le porteur des frais avec feeBearer.

Valeur	Effet
`CUSTOMER`	Les frais sont ajoutes au montant payable par le client
`MERCHANT`	Les frais sont supportes par le marchand

Les alias historiques customerPaysFees, customer_pays_fees, customerPaidFees et customer_paid_fees sont acceptes, mais feeBearer reste la forme recommandee.

Lire un lien public

curl "https://pay.soleaspay.com/link/A1B2C3D4"

Cette route est publique. Elle retourne les informations necessaires a l’affichage du checkout.

Payer un lien

curl -X POST "https://api.mysoleas.com/pay/A1B2C3D4/pay" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_phone": "237670000000",
    "customer_name": "Ada Client",
    "customer_email": "ada@example.com",
    "transaction_uuid": "65b0344e-0fc0-44f4-9f6f-ecdf6f41fbcb",
    "provider": "mtn_cmr",
    "channel": "PROVIDER"
  }'

La reponse contient la reference de transaction a suivre avec le flux de statut correspondant.

Lister vos liens

curl "https://api.mysoleas.com/payment-links?page=1&limit=25" \
  -H "x-sp-auth-token: Bearer YOUR_ACCESS_TOKEN"

Utilisez la pagination page et limit pour charger progressivement vos liens dans un backoffice.

Demarrer

Paiements

Catalogue

Montants et unités

Cas d’usage

Creer un lien

Gerer le montant

Gerer les frais

Lire un lien public

Payer un lien

Lister vos liens

​Montants et unités

​Cas d’usage

​Creer un lien

​Gerer le montant

​Gerer les frais

​Lire un lien public

​Payer un lien

​Lister vos liens

Montants et unités

Cas d’usage

Creer un lien

Gerer le montant

Gerer les frais

Lire un lien public

Payer un lien

Lister vos liens