CentralPay Documentation CentralPay Documentation
  • Informations générales
  • Documentation
  • Développeurs
CentralPay Documentation CentralPay Documentation
  • Informations générales
  • Documentation
  • Développeurs

Développeurs

  • Icône de dossier fermée Icône d’ouverture de dossierHow to use the swagger >
  • Icône de dossier fermée Icône d’ouverture de dossierPayment Request >
  • Icône de dossier fermée Icône d’ouverture de dossierCARD Transaction
    • Card token
    • Transaction
    • Card
    • Credit
    • Disputes
  • Icône de dossier fermée Icône d’ouverture de dossier3DS 2.2 >
  • Icône de dossier fermée Icône d’ouverture de dossierSDD Transaction
    • Mandate
    • SDD Transaction
    • SDD Transaction Reversal
  • Icône de dossier fermée Icône d’ouverture de dossierSCT Transaction
    • SCT Transaction
    • SCT Transaction Reversal
    • Bank Reconciliation
    • Bank Reconciliation external
  • Icône de dossier fermée Icône d’ouverture de dossierCustomer >
  • Icône de dossier fermée Icône d’ouverture de dossierSubscription
    • Subscription Model
    • Subscription
    • Invoice & invoiceItem
  • Icône de dossier fermée Icône d’ouverture de dossierInstallment Payment >
  • Icône de dossier fermée Icône d’ouverture de dossierRefund >
  • Icône de dossier fermée Icône d’ouverture de dossierBankAccount >
  • Icône de dossier fermée Icône d’ouverture de dossierOnboarding
    • Create Enrollement
    • Complete enrollment
    • Update enrollment
    • Search enrollement
    • Enrollment Details
    • E-money
    • Misc
  • Icône de dossier fermée Icône d’ouverture de dossierWallet >
  • Icône de dossier fermée Icône d’ouverture de dossierTransfer >
  • Icône de dossier fermée Icône d’ouverture de dossierTransferReversal >
  • Icône de dossier fermée Icône d’ouverture de dossierMerchantInfo >
  • Icône de dossier fermée Icône d’ouverture de dossierBlacklist >
  • Icône de dossier fermée Icône d’ouverture de dossierWhiteList >
  • Icône de dossier fermée Icône d’ouverture de dossierPayout >
  • Icône de dossier fermée Icône d’ouverture de dossierWebhook notifications
    • The BANKACCOUNT object
    • The CARD object
    • The CREDIT object
    • The CUSTOMER object
    • The DEPOSIT object
    • The DISPUTE object
    • The INSTALLMENT object
    • The ONBOARDING object
    • The PAYMENT REQUEST object
    • The PAYOUT object
    • The REFUND object
    • The SCT Transaction object
    • The SDD TRANSACTION object
    • The MANDATE object
    • The SUBSCRIPTION object
    • The TRANSACTION object
    • The TRANSFER REVERSAL object
    • The TRANSFER object
    • The WIRETRANSFER object (Deprecated)
  • Icône de dossier fermée Icône d’ouverture de dossierObject status
    • PAYMENT REQUEST status
    • TRANSACTION status
    • REFUND status
    • CREDIT status
    • DISPUTES status
    • SUBSCRIPTION status
    • INSTALLMENT status
    • SDD TRANSACTION status
    • MANDATE status
    • BANK ACCOUNT status
    • PAYOUT status
    • SCT TRANSACTION status
  • Icône de dossier fermée Icône d’ouverture de dossierResources by type
    • Codes
      • HTTP Codes
      • Bank return codes
      • Currency codes
      • SDD return codes
      • Country codes
      • Transfer purpose codes
      • SDD purpose codes
      • Error codes
    • Test values
      • Test IBAN values
      • Test cards Values

The TRANSACTION object

Temps estimé :13 minutes
TRANSACTION_SUCCEEDED
When a transaction has been approved by the issuing bank
{
  "eventId": "4774dddc-7163-40f9-a6e0-72cd52abad19",
  "type": "TRANSACTION_SUCCEEDED",
  "creationDate": "2024-01-05T14:43:21.487036+01:00",
  "object": {
    "additionalData": {},
    "amount": 3600000,
    "amountCaptured": 3600000,
    "amountRefunded": 0,
    "archivingReference": "5MS7NOWFGWSR",
    "arn": "123456",
    "authorizationCode": "000000",
    "authorizationMovementId": "0ee6bd7e-3e74-454d-a62b-120db043714d",
    "authorizationStatus": "SUCCESS",
    "bankCode": "0",
    "bankMessage": "Simulation : Transaction Approved",
    "browserAcceptLanguage": "en_US",
    "browserUserAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/101.0.4951.41 Safari/537.36",
    "captureDate": "2024-01-05T14:43:21.355125+01:00",
    "captureStatus": "CAPTURED",
    "card": {
      "additionalData": {},
      "cardId": "9a5602f8-ef06-4c00-ab62-c77f8a374eb2",
      "cardType": "DEBIT",
      "cardholderEmail": "test@gmail.com",
      "cardholderName": "MARIE ANNE",
      "check": true,
      "commercialBrand": "MASTERCARD",
      "country": "FRA",
      "creationDate": "2024-01-05T12:52:41.054394+01:00",
      "customerId": "1646e7fa-8274-48c0-9883-022c2e33fb22",
      "europeanEconomicArea": true,
      "expirationMonth": 9,
      "expirationYear": 2035,
      "fingerprint": "d409203bdcc673d1c527258a16c87cdad8767e1f",
      "first6": "532509",
      "infoId": "fc8b5c60-6044-41a6-8074-ed9499c245a5",
      "last4": "0008",
      "productType": "CORPORATE",
      "region": "EUROPE"
    },
    "cardPresent": {},
    "commission": 0,
    "contractId": "a674d481-4805-4a66-915a-67956efca36f",
    "country": "FRA",
    "creationDate": "2024-01-05T14:43:19.909652+01:00",
    "currency": "EUR",
    "customAcceptanceData": {},
    "customerId": "1646e7fa-8274-48c0-9883-022c2e33fb22",
    "endUserIp": "245.100.1.15",
    "endUserLanguage": "fre",
    "fee": 0,
    "merchantCategoryCode": "1711",
    "movementId": "899287b0-a0a5-413c-8be8-bc3d794ba96a",
    "order": {
      "cardholderEmail": "GDU-Solon40@gmail.com",
      "country": "FRA"
    },
    "partialAuthorization": false,
    "partialAuthorized": false,
    "payoutAmount": 3600000,
    "payoutCurrency": "EUR",
    "pointOfSaleId": "7d99a970-cc26-4de8-aa5d-d9ebf4088247",
    "receiptEmail": "GDU-Clemens7@yahoo.com",
    "refunded": false,
    "refunds": [],
    "residualAmount": 0,
    "source": "EC",
    "threeDSecure": false,
    "totalAmount": 3600000,
    "transactionId": "aa42bd28-5a34-47e4-87b0-3d25375be798",
    "transactionStatus": "SUCCESS",
    "transactiontransfers": [],
    "withCvv": true
  },
  "requestId": "3d82de99-2346-4eef-a30b-68e7efe5acd1"
}

TRANSACTION_CANCELED
When a transaction is cancelled
{
  "eventId": "2ed7535a-8d07-4502-aea8-d755c5584962",
  "type": "TRANSACTION_CANCELED",
  "creationDate": "2024-01-11T14:51:53.615072+01:00",
  "object": {
    "additionalData": {
      "key1": "value1",
      "key2": "value2"
    },
    "amount": 10,
    "amountCaptured": 10,
    "amountRefunded": 0,
    "archivingReference": "TSMEGRM4XQSN",
    "arn": "123456",
    "authorizationCode": "000000",
    "authorizationMovementId": "82dbefb7-2a49-4cf9-a10a-953e0fefd89b",
    "authorizationStatus": "SUCCESS",
    "bankCode": "0",
    "bankMessage": "Simulation : Transaction Approved",
    "cancelMovementId": "36238731-363a-4f30-913e-7a9b9defdd33",
    "captureCancellationDate": "2024-01-11T14:51:53.583865+01:00",
    "captureDate": "2024-01-11T14:50:33.400938+01:00",
    "captureStatus": "CANCELED",
    "card": {
      "additionalData": {},
      "cardId": "0f72740b-3a97-436b-aa78-9ac30308d404",
      "cardType": "DEBIT",
      "check": false,
      "commercialBrand": "VISA",
      "country": "FRA",
      "creationDate": "2024-01-11T14:50:31.216307+01:00",
      "europeanEconomicArea": true,
      "expirationMonth": 12,
      "expirationYear": 2026,
      "fingerprint": "31e7053d8ee3f13b4f391c989d83aaaa7771450d",
      "first6": "400000",
      "last4": "0002",
      "productType": "UNKNOWN",
      "region": "EUROPE"
    },
    "cardPresent": {},
    "commission": 0,
    "contractId": "a674d481-4805-4a66-915a-67956efca36f",
    "creationDate": "2024-01-11T14:50:32.194359+01:00",
    "currency": "EUR",
    "customAcceptanceData": {},
    "endUserIp": "245.100.1.15",
    "fee": 0,
    "merchantCategoryCode": "1711",
    "movementId": "36d934c8-de2f-43df-be49-a4f058c6c0ba",
    "order": {
      "addressLine1": "ADRESSE",
      "cardCountry": "FRA",
      "city": "PARIS",
      "country": "FRA",
      "firstName": "MANDATORY",
      "lastName": "MANDATORY"
    },
    "partialAuthorization": false,
    "partialAuthorized": false,
    "payoutAmount": 10,
    "payoutCurrency": "EUR",
    "pointOfSaleId": "7d99a970-cc26-4de8-aa5d-d9ebf4088247",
    "refunded": false,
    "refunds": [],
    "residualAmount": 0,
    "source": "EC",
    "threeDSecure": false,
    "totalAmount": 10,
    "transactionId": "2fbdd1ad-99e1-4fb6-a5f9-06239d7ef1a1",
    "transactionStatus": "SUCCESS",
    "transactiontransfers": [
      {
        "amount": 1,
        "destinationWalletId": "a00f7a69-b8c3-44b1-a8b2-aa508128b050",
        "escrowDate": "2024-01-15",
        "fee": 0,
        "merchantTransferId": "MRI_CODE"
      }
    ],
    "withCvv": true
  },
  "requestId": "2631c3f5-65cb-441f-9cb7-14dcf2c8d128"
}

TRANSACTION_CAPTURED
When a transaction is sent to the clearing and will be debited
{
  "eventId": "ecd3fead-ccb1-44e4-b41b-5806b78dc5a5",
  "type": "TRANSACTION_CAPTURED",
  "creationDate": "2024-01-05T14:43:21.513924+01:00",
  "object": {
    "additionalData": {},
    "amount": 3600000,
    "amountCaptured": 3600000,
    "amountRefunded": 0,
    "archivingReference": "5MS7NOWFGWSR",
    "arn": "123456",
    "authorizationCode": "000000",
    "authorizationMovementId": "0ee6bd7e-3e74-454d-a62b-120db043714d",
    "authorizationStatus": "SUCCESS",
    "bankCode": "0",
    "bankMessage": "Simulation : Transaction Approved",
    "browserAcceptLanguage": "en_US",
    "browserUserAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/101.0.4951.41 Safari/537.36",
    "captureDate": "2024-01-05T14:43:21.355125+01:00",
    "captureStatus": "CAPTURED",
    "card": {
      "additionalData": {},
      "cardId": "9a5602f8-ef06-4c00-ab62-c77f8a374eb2",
      "cardType": "DEBIT",
      "cardholderEmail": "test@gmail.com",
      "cardholderName": "MARIE ANNE",
      "check": true,
      "commercialBrand": "MASTERCARD",
      "country": "FRA",
      "creationDate": "2024-01-05T12:52:41.054394+01:00",
      "customerId": "1646e7fa-8274-48c0-9883-022c2e33fb22",
      "europeanEconomicArea": true,
      "expirationMonth": 9,
      "expirationYear": 2035,
      "fingerprint": "d409203bdcc673d1c527258a16c87cdad8767e1f",
      "first6": "532509",
      "infoId": "fc8b5c60-6044-41a6-8074-ed9499c245a5",
      "last4": "0008",
      "productType": "CORPORATE",
      "region": "EUROPE"
    },
    "cardPresent": {},
    "commission": 0,
    "contractId": "a674d481-4805-4a66-915a-67956efca36f",
    "country": "FRA",
    "creationDate": "2024-01-05T14:43:19.909652+01:00",
    "currency": "EUR",
    "customAcceptanceData": {},
    "customerId": "1646e7fa-8274-48c0-9883-022c2e33fb22",
    "endUserIp": "245.100.1.15",
    "endUserLanguage": "fre",
    "fee": 0,
    "merchantCategoryCode": "1711",
    "movementId": "899287b0-a0a5-413c-8be8-bc3d794ba96a",
    "order": {
      "cardholderEmail": "GDU-Solon40@gmail.com",
      "country": "FRA"
    },
    "partialAuthorization": false,
    "partialAuthorized": false,
    "payoutAmount": 3600000,
    "payoutCurrency": "EUR",
    "pointOfSaleId": "7d99a970-cc26-4de8-aa5d-d9ebf4088247",
    "receiptEmail": "GDU-Clemens7@yahoo.com",
    "refunded": false,
    "refunds": [],
    "residualAmount": 0,
    "source": "EC",
    "threeDSecure": false,
    "totalAmount": 3600000,
    "transactionId": "aa42bd28-5a34-47e4-87b0-3d25375be798",
    "transactionStatus": "SUCCESS",
    "transactiontransfers": [],
    "withCvv": true
  },
  "requestId": "3d82de99-2346-4eef-a30b-68e7efe5acd1"
}

TRANSACTION_EXPIRED
When a transaction is expired
{
  "eventId": "9a93ea00-42cc-4555-ad29-24daa2ec5fbe",
  "type": "TRANSACTION_EXPIRED",
  "creationDate": "2024-02-01T00:30:07.148454+01:00",
  "object": {
    "transactionId": "87b40109-0de5-454d-acf4-dfa51f23d15b",
    "creationDate": "2024-01-30T14:20:47.062768+01:00",
    "pointOfSaleId": "7d99a970-cc26-4de8-aa5d-d9ebf4088247",
    "contractId": "a674d481-4805-4a66-915a-67956efca36f",
    "merchantTransactionId": null,
    "archivingReference": "YB6J5BGOC4TF",
    "transactionStatus": "SUCCESS",
    "authorizationStatus": "SUCCESS",
    "bankCode": "0",
    "bankMessage": "Simulation : Transaction Approved",
    "authorizationCode": "000000",
    "riskScore": null,
    "source": "EC",
    "description": null,
    "currency": "EUR",
    "payoutCurrency": "EUR",
    "payoutAmount": null,
    "commission": null,
    "fee": 0,
    "amount": 36000,
    "partialAuthorization": false,
    "partialAuthorized": false,
    "partialAuthorizedAmount": null,
    "totalAmount": 36000,
    "card": {
      "cardId": "4970cff8-a3eb-4b7a-9f8e-6a4156c08cec",
      "creationDate": "2024-01-30T14:20:45.679621+01:00",
      "customerId": null,
      "cardTokenId": null,
      "infoId": null,
      "merchantCardId": null,
      "commercialBrand": "VISA",
      "first6": "403203",
      "last4": "3001",
      "expirationMonth": 12,
      "expirationYear": 2025,
      "country": "FRA",
      "cardholderName": null,
      "cardholderEmail": null,
      "description": null,
      "fingerprint": "a90fedc230c187acb2e4d6b8a3e3237044931beb",
      "cardType": "UNKNOWN",
      "region": "EUROPE",
      "productType": "UNKNOWN",
      "europeanEconomicArea": true,
      "check": false,
      "additionalData": {}
    },
    "cardMerchantToken": null,
    "captureStatus": "EXPIRED",
    "amountCaptured": 0,
    "refunded": true,
    "amountRefunded": 0,
    "refunds": [],
    "endUserIp": "8.8.8.8",
    "endUserLanguage": "fre",
    "browserUserAgent": null,
    "browserAcceptLanguage": null,
    "country": null,
    "receiptEmail": null,
    "transactiontransfers": [],
    "transferGroup": null,
    "residualAmount": null,
    "order": {
      "firstName": null,
      "lastName": null,
      "addressLine1": null,
      "addressLine2": null,
      "addressLine3": null,
      "addressLine4": null,
      "postalCode": null,
      "city": null,
      "country": null,
      "email": null,
      "phone": null,
      "cardCountry": "FRA",
      "cardholderName": null,
      "cardholderEmail": null
    },
    "dispute": null,
    "cardPresent": {
      "cardSequenceNumber": null,
      "cardEntryMode": null,
      "pinEntryCapability": null,
      "transactionSequenceCounter": null,
      "uniqueTerminalId": null,
      "cardholderSignatureImage": null,
      "gpsLatitude": null,
      "gpsLongitude": null,
      "cardholderPhoto": null,
      "cardAcceptorTerminalId": null,
      "offlinePinIndicator": null,
      "ucatTerminalIndicator": null,
      "iccData": null,
      "iccDataResponse": null
    },
    "clearingNumber": null,
    "merchantCategoryCode": "1711",
    "withCvv": true,
    "arn": "123456",
    "authorizationCancellationDate": null,
    "customerId": null,
    "captureDate": null,
    "clearingDate": null,
    "captureCancellationDate": null,
    "enrollmentId": null,
    "movementId": null,
    "authorizationMovementId": "258d16f5-3f5f-401d-8f5b-c9ff9d00f28d",
    "cancelMovementId": null,
    "paymentRequestBreakdownId": null,
    "paymentRequestId": null,
    "invoiceId": null,
    "installmentId": null,
    "customAcceptanceData": {},
    "additionalData": {
      "key1": "value1",
      "key2": "value2"
    },
    "3ds": false
  },
  "requestId": "fcf800bb-1748-4d23-9ce7-121c5f14a51b"
}

TRANSACTION_UPDATED
When a transaction is updated
{
  "eventId": "eaf9366e-cd66-4ab9-ad23-09ed2ec5972d",
  "type": "TRANSACTION_UPDATED",
  "creationDate": "2024-01-11T14:54:35.830032+01:00",
  "object": {
    "additionalData": {
      "key1": "value1",
      "key2": "value2"
    },
    "amount": 10,
    "amountCaptured": 10,
    "amountRefunded": 0,
    "archivingReference": "FLS2TYH3HJ5G",
    "arn": "123456",
    "authorizationCode": "000000",
    "authorizationMovementId": "02e0e9ec-77f6-4a75-9732-57a0d0844354",
    "authorizationStatus": "SUCCESS",
    "bankCode": "0",
    "bankMessage": "Simulation : Transaction Approved",
    "captureDate": "2024-01-11T14:53:18.688598+01:00",
    "captureStatus": "CAPTURED",
    "card": {
      "additionalData": {},
      "cardId": "180c71b5-9384-4ea5-9452-b190d4afc542",
      "cardType": "DEBIT",
      "check": false,
      "commercialBrand": "VISA",
      "country": "FRA",
      "creationDate": "2024-01-11T14:53:17.634328+01:00",
      "europeanEconomicArea": true,
      "expirationMonth": 1,
      "expirationYear": 2024,
      "fingerprint": "9e6b6fc8e48c4ee716efb06762e726c0108e5e8d",
      "first6": "400000",
      "last4": "0002",
      "productType": "UNKNOWN",
      "region": "EUROPE"
    },
    "cardPresent": {},
    "commission": 0,
    "contractId": "a674d481-4805-4a66-915a-67956efca36f",
    "creationDate": "2024-01-11T14:53:17.576925+01:00",
    "currency": "EUR",
    "customAcceptanceData": {},
    "endUserIp": "245.100.1.15",
    "fee": 0,
    "merchantCategoryCode": "1711",
    "movementId": "3dbd2c18-1110-496b-9cd2-1e7b7568fc00",
    "order": {
      "cardCountry": "FRA",
      "firstName": "MANDATORY",
      "lastName": "MANDATORY"
    },
    "partialAuthorization": false,
    "partialAuthorized": false,
    "payoutAmount": 10,
    "payoutCurrency": "EUR",
    "pointOfSaleId": "7d99a970-cc26-4de8-aa5d-d9ebf4088247",
    "receiptEmail": "test@gmail.com",
    "refunded": false,
    "refunds": [],
    "residualAmount": 0,
    "source": "EC",
    "threeDSecure": false,
    "totalAmount": 10,
    "transactionId": "8d08a5b1-413e-46d8-8e8e-6da8c0d5025b",
    "transactionStatus": "SUCCESS",
    "transactiontransfers": [
      {
        "amount": 1,
        "destinationWalletId": "a00f7a69-b8c3-44b1-a8b2-aa508128b050",
        "escrowDate": "2024-01-13",
        "fee": 0
      }
    ],
    "withCvv": true
  },
  "requestId": "6b85d1b7-853a-420e-a500-62aac18840c1",
  "objectBeforeUpdate": {
    "additionalData": {
      "key1": "value1",
      "key2": "value2"
    },
    "amount": 10,
    "amountCaptured": 10,
    "amountRefunded": 0,
    "archivingReference": "FLS2TYH3HJ5G",
    "arn": "123456",
    "authorizationCode": "000000",
    "authorizationMovementId": "02e0e9ec-77f6-4a75-9732-57a0d0844354",
    "authorizationStatus": "SUCCESS",
    "bankCode": "0",
    "bankMessage": "Simulation : Transaction Approved",
    "captureDate": "2024-01-11T14:53:18.688598+01:00",
    "captureStatus": "CAPTURED",
    "card": {
      "additionalData": {},
      "cardId": "180c71b5-9384-4ea5-9452-b190d4afc542",
      "cardType": "DEBIT",
      "check": false,
      "commercialBrand": "VISA",
      "country": "FRA",
      "creationDate": "2024-01-11T14:53:17.634328+01:00",
      "europeanEconomicArea": true,
      "expirationMonth": 1,
      "expirationYear": 2024,
      "fingerprint": "9e6b6fc8e48c4ee716efb06762e726c0108e5e8d",
      "first6": "400000",
      "last4": "0002",
      "productType": "UNKNOWN",
      "region": "EUROPE"
    },
    "cardPresent": {},
    "commission": 0,
    "contractId": "a674d481-4805-4a66-915a-67956efca36f",
    "creationDate": "2024-01-11T14:53:17.576925+01:00",
    "currency": "EUR",
    "customAcceptanceData": {},
    "endUserIp": "245.100.1.15",
    "fee": 0,
    "merchantCategoryCode": "1711",
    "movementId": "3dbd2c18-1110-496b-9cd2-1e7b7568fc00",
    "order": {
      "cardCountry": "FRA",
      "firstName": "MANDATORY",
      "lastName": "MANDATORY"
    },
    "partialAuthorization": false,
    "partialAuthorized": false,
    "payoutAmount": 10,
    "payoutCurrency": "EUR",
    "pointOfSaleId": "7d99a970-cc26-4de8-aa5d-d9ebf4088247",
    "refunded": false,
    "refunds": [],
    "residualAmount": 0,
    "source": "EC",
    "threeDSecure": false,
    "totalAmount": 10,
    "transactionId": "8d08a5b1-413e-46d8-8e8e-6da8c0d5025b",
    "transactionStatus": "SUCCESS",
    "transactiontransfers": [
      {
        "amount": 1,
        "destinationWalletId": "a00f7a69-b8c3-44b1-a8b2-aa508128b050",
        "escrowDate": "2024-01-13",
        "fee": 0
      }
    ],
    "withCvv": true
  }
}

TRANSACTION_DISPUTED
When a transaction is turned to a chargeback

{
  "eventId": "36e7853b-eecf-43d2-99ec-80aa5b26b46f",
  "type": "TRANSACTION_DISPUTED",
  "creationDate": "2024-01-05T15:16:28.316447+01:00",
  "object": {
    "additionalData": {},
    "amount": 36000,
    "amountCaptured": 36000,
    "amountRefunded": 0,
    "archivingReference": "AULQKEG8VFZV",
    "arn": "123456",
    "authorizationCode": "000000",
    "authorizationMovementId": "a7caf3b3-4d60-412e-9536-8b31e7fa2b99",
    "authorizationStatus": "SUCCESS",
    "bankCode": "0",
    "bankMessage": "Simulation : Transaction Approved",
    "browserAcceptLanguage": "en_US",
    "browserUserAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/101.0.4951.41 Safari/537.36",
    "captureDate": "2024-01-04T15:04:14.560777+01:00",
    "captureStatus": "CLEARED",
    "card": {
      "additionalData": {},
      "cardId": "9a5602f8-ef06-4c00-ab62-c77f8a374eb2",
      "cardType": "DEBIT",
      "cardholderEmail": "test@gmail.com",
      "cardholderName": "MARIE ANNE",
      "check": true,
      "commercialBrand": "MASTERCARD",
      "country": "FRA",
      "creationDate": "2024-01-05T12:52:41.054394+01:00",
      "customerId": "1646e7fa-8274-48c0-9883-022c2e33fb22",
      "europeanEconomicArea": true,
      "expirationMonth": 9,
      "expirationYear": 2035,
      "fingerprint": "d409203bdcc673d1c527258a16c87cdad8767e1f",
      "first6": "532509",
      "infoId": "fc8b5c60-6044-41a6-8074-ed9499c245a5",
      "last4": "0008",
      "productType": "CORPORATE",
      "region": "EUROPE"
    },
    "cardPresent": {},
    "clearingDate": "2024-01-05",
    "clearingNumber": "008194",
    "commission": 0,
    "contractId": "a674d481-4805-4a66-915a-67956efca36f",
    "country": "FRA",
    "creationDate": "2024-01-05T15:04:13.275733+01:00",
    "currency": "EUR",
    "customAcceptanceData": {},
    "customerId": "1646e7fa-8274-48c0-9883-022c2e33fb22",
    "dispute": {
      "additionalData": {},
      "amount": 10,
      "creationDate": "2024-01-05T15:16:27.776882+01:00",
      "currency": "EUR",
      "disputeDate": "2021-03-18",
      "disputeId": "896304e9-b937-443a-ba59-3ccc99931b00",
      "fee": 0,
      "movementId": "09e2b390-a5a6-4926-a5ad-41c96bd38cea",
      "reason": "FRAUDULENT",
      "status": "CHARGEBACK_NOTICED",
      "transactionId": "8940d775-cb9c-46e4-ab5a-c5c3ea7c3116"
    },
    "endUserIp": "245.100.1.15",
    "endUserLanguage": "fre",
    "fee": 0,
    "merchantCategoryCode": "1711",
    "movementId": "15560735-1636-4a01-9a15-89eab54ef9e1",
    "order": {
      "cardholderEmail": "GDU-Dasia77@hotmail.com",
      "country": "FRA"
    },
    "partialAuthorization": false,
    "partialAuthorized": false,
    "payoutAmount": 36000,
    "payoutCurrency": "EUR",
    "pointOfSaleId": "7d99a970-cc26-4de8-aa5d-d9ebf4088247",
    "receiptEmail": "GDU-Benton_Hamill8@gmail.com",
    "refunded": false,
    "refunds": [],
    "residualAmount": 0,
    "source": "EC",
    "threeDSecure": false,
    "totalAmount": 36000,
    "transactionId": "8940d775-cb9c-46e4-ab5a-c5c3ea7c3116",
    "transactionStatus": "SUCCESS",
    "transactiontransfers": [],
    "withCvv": false
  },
  "requestId": "29ae33a7-bcd3-405f-ab21-485729b980aa"
}

TRANSACTION_FAILED
When a transaction has been declined by the issuing bank
{
  "eventId": "0eeacc49-8957-4910-925f-d633505f23b0",
  "type": "TRANSACTION_FAILED",
  "creationDate": "2024-01-05T14:46:59.392077+01:00",
  "object": {
    "additionalData": {},
    "amount": 3600000,
    "amountCaptured": 0,
    "amountRefunded": 0,
    "archivingReference": "9GUGCIZEU0VN",
    "authorizationMovementId": "7ed9258a-ee75-4705-90f3-678973d2402e",
    "authorizationStatus": "FAILURE",
    "bankCode": "51",
    "bankMessage": "Simulation : Insufficient Funds",
    "browserAcceptLanguage": "en_US",
    "browserUserAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/101.0.4951.41 Safari/537.36",
    "captureStatus": "UNCAPTURED",
    "card": {
      "additionalData": {},
      "cardId": "30e49b6e-ed07-4b43-8862-2abd2f181678",
      "cardType": "DEBIT",
      "cardholderEmail": "gduhamel@centralpay.eu",
      "check": true,
      "commercialBrand": "VISA",
      "country": "FRA",
      "creationDate": "2024-01-05T14:46:39.151564+01:00",
      "customerId": "1646e7fa-8274-48c0-9883-022c2e33fb22",
      "europeanEconomicArea": true,
      "expirationMonth": 9,
      "expirationYear": 2035,
      "fingerprint": "7032968c1a882c155b3d8014297daabaa7133680",
      "first6": "400000",
      "infoId": "90eaf823-e2e7-4757-845a-b966bbab03c6",
      "last4": "0077",
      "productType": "UNKNOWN",
      "region": "EUROPE"
    },
    "cardPresent": {},
    "contractId": "a674d481-4805-4a66-915a-67956efca36f",
    "country": "FRA",
    "creationDate": "2024-01-05T14:46:58.190985+01:00",
    "currency": "EUR",
    "customAcceptanceData": {},
    "customerId": "1646e7fa-8274-48c0-9883-022c2e33fb22",
    "endUserIp": "245.100.1.15",
    "endUserLanguage": "fre",
    "fee": 0,
    "merchantCategoryCode": "1711",
    "order": {
      "cardholderEmail": "GDU-Yvette5@hotmail.com",
      "country": "FRA"
    },
    "partialAuthorization": false,
    "partialAuthorized": false,
    "payoutCurrency": "EUR",
    "pointOfSaleId": "7d99a970-cc26-4de8-aa5d-d9ebf4088247",
    "receiptEmail": "GDU-Buck_Gislason@hotmail.com",
    "refunded": false,
    "refunds": [],
    "source": "EC",
    "threeDSecure": false,
    "totalAmount": 3600000,
    "transactionId": "d530cdbe-b9fc-481b-b99d-8ce0db75deb4",
    "transactionStatus": "FAILURE",
    "transactiontransfers": [],
    "withCvv": true
  },
  "requestId": "c120a3c0-764a-4c7e-a705-4721784212c7"
}

TRANSACTION_FRAUDULENT
When a transaction is refused because it has meet a blacklist element (Email, IP, Card, …)

{
  "eventId": "d489a6be-9b6d-43fa-86e3-c5d26437aac3",
  "type": "TRANSACTION_FRAUDULENT",
  "creationDate": "2024-01-05T16:34:30.947564+01:00",
  "object": {
    "additionalData": {},
    "amount": 500,
    "amountCaptured": 0,
    "amountRefunded": 0,
    "authorizationStatus": "FRAUD",
    "bankMessage": "PAN in BLACKLIST [532509xxx0008]",
    "captureStatus": "UNCAPTURED",
    "card": {
      "additionalData": {},
      "cardId": "4680d102-96b0-4fba-b00c-3375ee610fc7",
      "cardType": "DEBIT",
      "cardholderEmail": "gduhamel@centralpay.eu",
      "check": true,
      "commercialBrand": "MASTERCARD",
      "country": "FRA",
      "creationDate": "2024-01-05T16:33:13.699153+01:00",
      "customerId": "33c36fb3-fec8-4930-9cb6-32e2b76d61c9",
      "europeanEconomicArea": true,
      "expirationMonth": 9,
      "expirationYear": 2035,
      "fingerprint": "d409203bdcc673d1c527258a16c87cdad8767e1f",
      "first6": "532509",
      "infoId": "dabeaee8-1f45-438e-b9c7-37bbce92315e",
      "last4": "0008",
      "productType": "CORPORATE",
      "region": "EUROPE"
    },
    "cardPresent": {},
    "contractId": "a674d481-4805-4a66-915a-67956efca36f",
    "creationDate": "2024-01-05T16:34:30.385545+01:00",
    "currency": "EUR",
    "customAcceptanceData": {},
    "customerId": "33c36fb3-fec8-4930-9cb6-32e2b76d61c9",
    "endUserIp": "245.100.1.15",
    "merchantTransactionId": "MIP_001",
    "order": {
      "cardCountry": "FRA",
      "cardholderEmail": "gduhamel@centralpay.eu",
      "email": "gduhamel@centralpay.eu",
      "firstName": "CECELIA",
      "lastName": "EBERT"
    },
    "partialAuthorization": false,
    "payoutCurrency": "EUR",
    "pointOfSaleId": "7d99a970-cc26-4de8-aa5d-d9ebf4088247",
    "receiptEmail": "gduhamel@centralpay.eu",
    "refunded": false,
    "refunds": [],
    "source": "EC",
    "threeDSecure": false,
    "totalAmount": 500,
    "transactionId": "f061fa00-8494-4eca-b9d1-f54d36125d7d",
    "transactionStatus": "FRAUD",
    "transactiontransfers": [],
    "withCvv": true
  },
  "requestId": "47c8329d-b686-4dc0-ad21-941e4ec2945d"
}

TRANSACTION_NOT_ACCEPTED
When a transaction is refused because entering an acceptance rule

TRANSACTION_REFUNDED
When a transaction has been refunded to the card holder
{
  "eventId": "21f8a3b1-1fab-4071-9f75-ef36d10a6572",
  "type": "TRANSACTION_REFUNDED",
  "creationDate": "2024-01-10T09:35:28.762354+01:00",
  "object": {
    "additionalData": {},
    "amount": 36000,
    "amountCaptured": 36000,
    "amountRefunded": 36000,
    "archivingReference": "YNADK4W3G2EK",
    "arn": "123456",
    "authorizationCode": "000000",
    "authorizationMovementId": "679d6b91-bba5-43fa-a444-b3aa7fb2ad2f",
    "authorizationStatus": "SUCCESS",
    "bankCode": "0",
    "bankMessage": "Simulation : Transaction Approved",
    "browserAcceptLanguage": "en_US",
    "browserUserAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/101.0.4951.41 Safari/537.36",
    "captureDate": "2024-01-04T15:04:11.419479+01:00",
    "captureStatus": "CLEARED",
    "card": {
      "additionalData": {},
      "cardId": "9a5602f8-ef06-4c00-ab62-c77f8a374eb2",
      "cardType": "DEBIT",
      "cardholderEmail": "test@gmail.com",
      "cardholderName": "MARIE ANNE",
      "check": true,
      "commercialBrand": "MASTERCARD",
      "country": "FRA",
      "creationDate": "2024-01-05T12:52:41.054394+01:00",
      "customerId": "1646e7fa-8274-48c0-9883-022c2e33fb22",
      "europeanEconomicArea": true,
      "expirationMonth": 9,
      "expirationYear": 2035,
      "fingerprint": "d409203bdcc673d1c527258a16c87cdad8767e1f",
      "first6": "532509",
      "infoId": "fc8b5c60-6044-41a6-8074-ed9499c245a5",
      "last4": "0008",
      "productType": "CORPORATE",
      "region": "EUROPE"
    },
    "cardPresent": {},
    "clearingDate": "2024-01-05",
    "clearingNumber": "008194",
    "commission": 0,
    "contractId": "a674d481-4805-4a66-915a-67956efca36f",
    "country": "FRA",
    "creationDate": "2024-01-05T15:04:10.135397+01:00",
    "currency": "EUR",
    "customAcceptanceData": {},
    "customerId": "1646e7fa-8274-48c0-9883-022c2e33fb22",
    "endUserIp": "245.100.1.15",
    "endUserLanguage": "fre",
    "fee": 0,
    "merchantCategoryCode": "1711",
    "movementId": "656895c7-e7a2-4b7d-8920-0bb78ea45f3a",
    "order": {
      "cardholderEmail": "GDU-Martina_Ondricka@hotmail.com",
      "country": "FRA"
    },
    "partialAuthorization": false,
    "partialAuthorized": false,
    "payoutAmount": 36000,
    "payoutCurrency": "EUR",
    "pointOfSaleId": "7d99a970-cc26-4de8-aa5d-d9ebf4088247",
    "receiptEmail": "GDU-Justyn98@gmail.com",
    "refunded": true,
    "refunds": [
      {
        "additionalData": {},
        "amount": 36000,
        "commission": 0,
        "creationDate": "2024-01-10T09:35:28.448559+01:00",
        "currency": "EUR",
        "description": "GDU-testapi",
        "fee": 0,
        "movementId": "c42ea27a-6d74-4c4b-b170-e17762916c79",
        "payoutAmount": 36000,
        "payoutCurrency": "EUR",
        "refundId": "9bf06654-c023-4481-8e6a-138bb5f13777",
        "status": "UNCLEARED",
        "transactionId": "2a06bfae-51f5-4dd7-945b-47631c16cb9c"
      }
    ],
    "residualAmount": 0,
    "source": "EC",
    "threeDSecure": false,
    "totalAmount": 36000,
    "transactionId": "2a06bfae-51f5-4dd7-945b-47631c16cb9c",
    "transactionStatus": "SUCCESS",
    "transactiontransfers": [],
    "withCvv": false
  },
  "requestId": "794c20b2-4a0c-4d9d-a580-af5544c11120"
}

TRANSACTION_RISKY
When a transaction is refused because of its risk score exceed the limit

TRANSACTION_THREEDS_AUTH_FAILED
When a transaction is declined because the card holder failed to authenticate himself during the 3DS process
Webhook notifications -Précédent The SUBSCRIPTION object Prochain- Webhook notifications The TRANSFER REVERSAL object
CONTENU

Doc Contents

Doc Footnotes

Doc Elements

  • Mentions légales
  • Politique de confidentialité

© 2024 CentralPay