Verify Stored Payment Option

To verify SEPA stored payment option there are two API methods involved - 1.56 - Init Verify Stored Payment Option and 1.57 - Complete Verify Stored Payment Option

info

If 1.56 - Init Verify Stored Payment Option is triggered then €0.01 will be transfered from the program account to the specified stored payment option of the end customer; the transaction usage reason will include a 6 digit code which the end customer will be able to provide via a UI which the merchant implements to collect the code and then submit this to the 1.57 - Complete Verify Stored Payment Option method.

Init Verify Stored Payment Option Request

Path:

POST {baseURL}/account/{accno}/storedPaymentOptions/{storedPaymentOptionReference}/initVerify

Header:

Content-Type: application/json
Accept-Language: en-US
X-Auth-Token: eyJhbGciOiJSUzI1NiI{abbreviated}RW5kVG9rZW4=

{
    "partnerReference": "1234567890",
    "programAccno": "123456",
    "accnoType": "00",
    "localDate": "2014-03-12",
    "localTime": "163835"
}

Init Verify Stored Payment Option Response

Status Code:

200 (OK)

Header:

Content-Type: application/json
Accept-Language: en-US

{
    "partnerReference": "1234567890",
    "programCode": "PROG",
    "accno": "XXX-123456",
    "localDate": "2014-03-12",
    "localTime": "163835",
    "sysDate": "2014-03-12",
    "sysTime": "153837",
    "responseCode": "0000",
    "responseDescription": "Successful execution.",
    "additionalInformation": {
        "requestId": "aff2728481a181dc36daedc14055b516"
    }
}

Complete Verify Stored Payment Option Request

Path:

POST {baseURL}/account/{accno}/storedPaymentOptions/{storedPaymentOptionReference}/completeVerify

Header:

Content-Type: application/json
Accept-Language: en-US
X-Auth-Token: eyJhbGciOiJSUzI1NiI{abbreviated}RW5kVG9rZW4=

{
    "partnerReference": "1234567890",
    "programCode": "PROG",
    "accnoType": "00",
    "verificationCode": "123456",
    "localDate": "2014-03-12",
    "localTime": "163835"
}

Complete Verify Stored Payment Option Successful Response

Status Code:

200 (OK)

Header:

Content-Type: application/json
Accept-Language: en-US

{
    "partnerReference": "1234567890",
    "programCode": "PROG",
    "accno": "XXX-123456",
    "localDate": "2014-03-12",
    "localTime": "163835",
    "sysDate": "2014-03-12",
    "sysTime": "153837",
    "responseCode": "0000",
    "responseDescription": "Successful execution.",
    "additionalInformation": {
        "requestId": "aff2728481a181dc36daedc14055b516"
    }
}

note

If the verification code passed in 1.57 Complete Verify Stored Payment Option is incorrect you will receive response code "responseCode": "0662" and "responseDescription": "Verification code is incorrect".

Complete Verify Stored Payment Option Unsuccessful Response

Status Code:

400

Header:

Content-Type: application/json
Accept-Language: en-US

{
    "partnerReference": "DancePartnereref",
    "responseCode": "0662",
    "responseDescription": "Verification code is incorrect.",
    "additionalInformation": {
        "requestId": "aff2728481a181dc36daedc14055b516"
    }
}