• France
Merchant Back Office
assistance
FAQContact support
Search
Categories
Tags
English
French
English
Homepage
Use cases
Create a payment
Create an installment payment
Create a payment by Alias (Token)
Create a payment link
Create a recurring payment
Manage subscriptions
Manage your transactions (refund, cancel...)
Analyze your reports
API docs
Embedded Form
REST API
Hosted payment
Mobile payment
File exchange
Snippets
Payment methods
Plugins
Guides
Merchant Back Office
Functional guides

OTP OSB - Invalid OTP

To test this scenario, use the card number below:

CARD Expiry date Label
9250003140000000227 To be chosen PRIV_OPT

Exchange flow

1. Initial call to the PCI/Charge/Authenticate service.

{
  "amount":"990",
  "currency":"XPF",
  "transactionCategory":"PAYMENT",    
  "merchant": {
    "mid":"2222222"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"25",
    "networkPreference":"OSB",
    "pan":"9250003140000000227"
  },
  "customer": {
    "reference" : "11111"
  },  
  "device": {
    "acceptHeader":"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9",
    "colorDepth":"24",
    "deviceType":"BROWSER",
    "ip":"69.89.31.226",
    "javaEnabled":false,
    "language":"fr-FR",
    "screenHeight":"1024",
    "screenWidth":"1280",
    "timeZoneOffset":"-120",
    "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36"
  },
  "protocolRequest": {
    "name":"OSB",
    "version":"1",
    "challengePreference":"NO_PREFERENCE"
  }
}

2. Return with a CHALLENGE instruction for redirection to the authentication page (iFrame visible).

{
  "webService":"PCI/Charge/Authenticate",
  "version":"V4",
  "applicationVersion":"5.24.0",
  "serverDate":"2021-05-21T13:37:41+00:00",
  "ticket":"85e682f0cc4f4800b34a16fe4bf33503",
  "applicationProvider":"",
  "metadata":null,
  "status":"SUCCESS",
  "mode":"TEST",
  "serverUrl":"https://api.secure.osb.pf",
  "_type":"V4/WebService/Response",
  "answer":{
    "id":"4b69e6ba-7edb-4871-aded-162cb5353731",
    "protocol":{
      "name":"OSB",
      "version":"1.0.0",
      "network":"OSB",
      "challengePreference":"NO_PREFERENCE",
      "simulation":true,
      "_type":"V4/Charge/Authenticate/Protocol"
    },
    "value":{
      "instructionType":"FORM",
      "name":"CHALLENGE",
      "timeout":120,
      "target":{
        "element":"IFRAME",
        "visible":true,
        "width":390,
        "height":595,
        "_type":"V4/Charge/Authenticate/InstructionTarget",
        "showUrl":false
      },
      "http":{
        "method":"POST",
        "url":"https://pass.sample-acs.net/public/v1/otp/OSB/1.0.0/4b69e6ba-7edb-4871-aded-162cb5353731/challenge",
        "body":{
          "sessionData":"H4sIAAAAAAAAAD1SyZ..."
        },
        "_type":"V4/Charge/Authenticate/HttpRequest"
      },
      "_type":"V4/Charge/Authenticate/AuthenticationInstruction"
    },
    "_type":"V4/AuthenticationResponseData"
  }
}

3. Redirection to the ACS in the iFrame, cardholder authentication.

The characteristics of the Iframe are given in the answer.value.target object. The form to be displayed in the Iframe is described in the answer.value.http object.

4. Return via the browser with an instruction result.

{
  "eventName":"LYRA_AUTH_INSTRUCTION_RESULT",
  "value":{
    "name":"CHALLENGE",
    "value":"eyJjZXJ0aWZpY2...",
    "protocol":{
      "name":"OSB",
      "version":"1.0.0",
      "network":"OSB",
      "challengePreference":"NO_PREFERENCE",
      "simulation":true
    }
  }
}

5. A new call to the PCI/Charge/Authenticate service transmitting this result.

{
  "amount":"990",
  "currency":"XPF",
  "transactionCategory":"PAYMENT",    
  "merchant": {
    "mid":"2222222"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"25",
    "networkPreference":"OSB",
    "pan":"9250003140000000227"
  },
  "customer": {
    "reference" : "11111"
  },  
  "device": {
    "acceptHeader":"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9",
    "colorDepth":"24",
    "deviceType":"BROWSER",
    "ip":"69.89.31.226",
    "javaEnabled":false,
    "language":"fr-FR",
    "screenHeight":"1024",
    "screenWidth":"1280",
    "timeZoneOffset":"-120",
    "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36"
  },
  "protocolRequest": {
    "name":"OSB",
    "version":"1",
    "challengePreference":"NO_PREFERENCE"
  },
  "id":"4b69e6ba-7edb-4871-aded-162cb5353731",
  "instructionResult": {
    "name" : "CHALLENGE",      
    "protocol" : {
      "name" : "OSB",
      "network":"OSB",
      "version" : "1.0.0",
      "challengePreference":"NO_PREFERENCE",
      "simulation": 1
    },
    "value":"eyJjZXJ0aWZpY2F0ZSI6Il..."
  }      
}

6. Answer of the payment gateway server with the final authentication result.

{
  "webService":"PCI/Charge/Authenticate",
  "version":"V4",
  "applicationVersion":"5.24.0",
  "serverDate":"2021-05-21T13:49:09+00:00",
  "ticket":"85e682f0cc4f4800b34a16fe4bf33503",
  "applicationProvider":"OSB",
  "metadata":null,
  "status":"SUCCESS",
  "mode":"TEST",
  "serverUrl":"https://api.secure.osb.pf",
  "_type":"V4/WebService/Response",
  "answer":{
    "id":"4b69e6ba-7edb-4871-aded-162cb5353731",
    "protocol":{
      "name":"OSB",
      "version":"1.0.0",
      "network":"OSB",
      "challengePreference":"NO_PREFERENCE",
      "simulation":true,
      "_type":"V4/Charge/Authenticate/Protocol"
    },
    "value":{
      "authenticationType":"CHALLENGE",
      "authenticationId":{
        "authenticationIdType":"dsTransId",
        "value":"4b69e6ba-7edb-4871-aded-162cb5353731",
        "_type":"V4/Charge/Authenticate/AuthenticationId"
      },
      "status":"FAILED",
      "extension":{
        "authenticationType":"OSB_V1",
        "responseCode":"00",
        "infoSupp":[
          "simulator",
          "input error count : 3"
        ],
        "_type":"V4/Charge/Authenticate/AuthenticationResultExtensionOsbV1"
      },
      "reason":{
        "code":"AUTHENTICATION_ERROR",
        "message":"simulator|input error count : 3",
        "_type":"V4/Charge/Authenticate/AuthenticationResultReason"
      },
      "_type":"V4/Charge/Authenticate/AuthenticationResult"
    },
    "_type":"V4/AuthenticationResponseData"
  }
}
© 2025 {'|'} All rights reserved to PayZen by OSB
25.25.0-1.11