Créez votre premier paiement

Pour effectuer votre premier paiement, utilisez simplement l'API suivante :

Créer un paiement

.POST https://neopay.io/api/payments

Headers

{
    "Authorization": "<my-app-token>",
    "x-app-key": "<my-app-key>",
    "Content-Type": "application/json/",
    "Accept": "application/json"
}

{info.fa-hint} <my-app-token> est le jeton généré pour votre application {info.fa-hint} <my-app-key> est obtenu dans votre portail d'application en tant que Application ID

Exemple de body de requête

{
    "institutionId": 20,
    "payment": {
        "amount": 122.44,
        "currency": "GBP"
    },
    "customer": {
        "id": "99618204-6daf-4eca-8180-c21bb8d8ee24",
        "name": "Jhon Doe",
        "email": "jhondoe@email.com",
        "country": "GB"
    },
    "reference": "reference",
    "callback_url": "https://webhook.site/2d9eefba-3ac8-4692-a0ec-d57dd3ce3abd"
}
Field Type Description
institutionId Integer L'identifiant de l'établissement. (Requis)
payment Object Les détails du paiement. (Requis)
payment.amount Number Montant du paiement (obligatoire)
payment.currency String La devise du paiement. (Requis)
customer Object Les coordonnées du client (Obligatoire)
customer.id UUID L'UUID du client (obligatoire si vous n'envoyez pas le customer.email )
customer.email String L'email du client (Obligatoire si vous n'envoyez pas le customer.id )
customer.name String Le nom du client (facultatif)
customer.country String Le pays du client (Obligatoire )
customer.resource Resource Ressource client complète
reference String Référence de paiement (facultatif)
callback_url String URL de rappel de paiement (facultatif)

Exemple de réponse

Réponse réussie :


HTTP 200 
{
    "message": "Payment saved successfully!",
    "payment": {
        "id": "9968c3db-b398-46ab-962e-08c1d52e8061",
        "application_id": "995d8ae8-b47f-4b3d-b411-e325d95f6ffd",
        "amount": 122.44,
        "status": "pending",
        "currency": "GBP",
        "country": "GB",
        "service": "api",
        "environment": "sandbox",
        "institution": {
            "id": 20,
            "name": "Modelo Sandbox"
        },
        "customer": {
            "id": "9968c3db-9d70-4751-b2e0-6d74ce8b1be6",
            "name": "Jhon doe",
            "email": "jhondoe@email.com",
            "currency": "GBP",
            "country": "GB"
        },
        "payee": {
            "name": "jOHN",
            "country_code": "GB",
            "bank_name": "MODELO",
            "accountable": "DE89370400440532013000",
            "swift_bic": "AACSDE33"
        },
        "created_at": "2023-06-14T14:20:16.000000Z",
        "updated_at": "2023-06-14T14:20:16.000000Z",
        "authorisationUrl": "Url of payment authorized"
    }
}