L'API Payments permet d’intégrer facilement une solution de paiement sécurisée par virement simplifié (instantané ou classique) directement dans vos applications métiers. Utilisez notre API pour fluidifier et sécuriser votre parcours client, tout en facilitant le suivi de vos paiements.
Simplifiez votre réconciliation bancaire
Le service Payments vous permet de simplifier votre réconciliation bancaire. Voici les informations essentielles pour vous aider dans cette démarche.
Le champ “label”
Le libellé présent dans la demande de paiement est transmis aux établissements bancaires. Cette information est reportée par les banques dans le relevé bancaire du bénéficiaire et du payeur.
Lors de la création de la demande de paiement "POST /orders", personnalisez le libellé pour faciliter votre réconciliation bancaire :
Base Url : POST https://pay.oxlin.io/v1/orders
Exemple requête :
curl --request POST --location 'https://pay.oxlin.io/v1/orders' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxx \
--data-raw '{
"redirect_url": "https://www.example.com/",
"amount": "10",
"currency": "EUR",
"email": "user@example.com",
"beneficiary":
{
"schema": "SEPA",
"iban": "FR8530003000307599775722N09",
"name": "firstname lastname"
},
"label": "Utilisez ce champ pour faciliter la réconciliation"
}'
Exemple de libellé dans le relevé bancaire du bénéficiaire
Dans le relevé bancaire :
Dans l’application bancaire :
Le champ “end_to_end_id”
Le end_to_end_id est un identifiant unique de transaction transmis aux établissements bancaires. Cette information est reportée par les banques dans le relevé bancaire du bénéficiaire et du payeur.
Le end_to_end_id d’une demande de paiement est disponible dans la section “instructions” des réponses aux requêtes “GET /reporting/orders” et “GET /running/orders” :
Base Url : GET https://pay.oxlin.io/v1/reporting/orders
Base Url : GET https://pay.oxlin.io/v1/running/orders
Exemple requête “GET /reporting/orders”:
curl --request GET --location 'https://pay.oxlin.io/v1/reporting/orders/<order_id>' \
--header 'Authorization: Bearer xxxxx
Exemple requête “GET /running/orders”:
curl --request GET --location 'https://pay.oxlin.io/v1/running/orders/<order_id>' \
--header 'Authorization: Bearer xxxxx
Exemple réponse :
{
"id": "<order_id>",
…
"instructions": [
{
"id": "XXX",
"amount": "1",
"currency": "EUR",
"beneficiary": {
…
},
"label": "Facture-XXX,
"end_to_end_id": "7fd1398ca13f4c18a78b2ee6ca2f0a47"
}
],
"payer_time_zone": "Europe/Paris",
"refundable_amount": 0
}
Exemple d’end_to_end_id dans le relevé bancaire du bénéficiaire
Dans le relevé bancaire :
Dans l’application bancaire :
Ces informations ont-elles répondu à vos interrogations ?
Si vous rencontrez des difficultés, n'hésitez pas à contacter notre équipe Support via ce lien