worldline

Documentation

Account verification

Account verification can be initiated to verify if the provided card account exist. This can also be used while storing the card credentials for future usage in the form of Card-On-File (COF) transactions or at the time of getting the cardholder entered into a Merchant Initiated Transaction (MIT) agreement.

Verify an account

Submit a verify account request to complete an account verification. Below is an example request and response.

{
    "operationId": "8fe8cf9a-3f82-4f72-9a5c-7486071352df",
    "transactionTimestamp": "2024-08-19T13:58:08.527Z",
    "cardPaymentData": {
        "brand": "VISA",
        "cardData": {
            "cardNumber": "4176669999000104",
            "expiryDate": "122031",
            "cardSecurityCode": "012"
        },
        "cardEntryMode": "ECOMMERCE",
        "cardholderVerificationMethod": "THREE_DS",
        "ecommerceData": {
            "threeDSecure": {
                "threeDSecureType": "THREE_DS",
                "authenticationValue": "AAABBEg0VhI0VniQEjRWAAAAAAA=",
                "directoryServerTransactionId": "15da15ce-aac6-4807-94e5-4ce76a1e5623",
                "version": "2.2.0",
                "eci": "05"
            }
        }
    },
    "references": {
        "merchantReference": "Your-Order-9136c995-3e7c-4f95-b901-7bebfd857946"
    }
}
{
    "operationId": "4e962010-656a-4d32-a596-26e143c97435",
    "responseCode": "0",
    "responseCodeDescription": "Accepted or completed successfully",
    "responseCodeCategory": "APPROVED",
    "responder": "WORLDLINE",
    "authorizationCode": "062714",
    "cardPaymentData": {
        "brand": "VISA",
        "ecommerceData": {
            "cardSecurityCodeResult": "MATCH"
        }
    },
    "references": {
        "retrievalReferenceNumber": "123456789012",
        "schemeTransactionId": "304232535995347",
        "paymentAccountReference": "Q1J4AwSWD4Dx6q1DTo0MB21XDAV76"
    }
}

Please refer to response handling to understand the key response properties and build your integration accordingly.