Step 4: Create Transaction

Once the user has selected their bank you need to create the transaction. This will return the first bank message response which will contain the bank login fields.

Table Template

Url secure/transaction/create/:requestId/:bankId

Method GET

Headers See Common Headers. No data is posted so the Content-Type header can be excluded.

URL Params

Name	Type	Description
requestId	guid	The request identifier (Same as returned by the Create Request method).
bankId	guid	The identifier for the bank selected by the user.

Data Params N/A

Response Object See Bank Messages response object.

Request Example

               
GET https://api.ozow.com/secure/transaction/create/5fabd...2653f/481601..16dcc4ec HTTP/1.1
Accept: application/json
Authorization: Bearer sNpM_uzQ8WerQvYuA...4IFTKHXaVc1sJ3FvJU

Response Example

               
{
    "error":null,
    "display":{
        "title":"Login",
        "instructions":"Please enter your username and password",
        "inputFields":[
            {
                "name":"user",
                "defaultValue":"",
                "maxLength":100,
                "label":"Username",
                "type":"Text",
                "group":"Username"
            },
            {
                "name":"Password",
                "defaultValue":"",
                "maxLength":100,
                "label":"Password",
                "type":"Password",
                "group":"Password"
            }
        ],
        "type":"Form",                                             
        "actionText":"Login",
        "allowResend":false,
        "resendDelay":0
    },
    "transaction":{
        "id":"b86e12a1-80bb-48fd-951a-05af0853e403",
        "step":"Login",
        "status":null,
        "statusMessage":null,
        "receiptId":null
    }
}

Continue to Step 5: Bank Messages