Verification status

Introduction

Verification status is initiated through HTTPS POST request by using URLs and the parameters.

Verification status request is made by Connecting Party’s app to Billblend to get the status of verification transaction.
It is recommended to send Verification status request for a period of 2-3 minutes with interval of 3-5 seconds between requests.
Connecting Party’s server should rely on the callback for final status.

API URLs

Integration	Production
https://sandbox.billblend.com/checkout/dapi/v1/verification/{endpointId}/{invoiceId}/status	https://pay.billblend.com/checkout/dapi/v1/verification/{endpointId}/{invoiceId}/status

Request Parameters

Parameter Name	Description	Value
session		`Necessity`: Required `Type`: Object
session.accessToken	The access token key received in Optional consumer authentication.	`Necessity`: Required `Type`: String `Length`: 32-128
session.token	The session token of verification transaction.	`Necessity`: Required `Type`: String `Length`: 16-36

Success Response Parameters

Parameter Name	Description	Value
invoiceId	Verification transaction identifier.	`Type`: String
session		`Type`: Object
session.token	The session token of verification transaction.	`Type`: String
state	Possible values: `PROCESSING`, `REDIRECT_REQUEST`, `APPROVED`, `DECLINED`.	`Type`: Enum
bankOrderId	Required if state is `APPROVED` or `DECLINED`.	`Necessity`: Conditional `Type`: String `Length`: 128
redirectUrl	Required if state is `REDIRECT_REQUEST`.	`Necessity`: Conditional `Type`: String `Length`: 128
errorCode	Decline reason code, may present if state is `DECLINED`.	`Necessity`: Optional `Type`: Integer `Length`: 128
errorMessage	Decline reason message, may present if state is `DECLINED`.	`Necessity`: Optional `Type`: String `Length`: 128
secure3DAuthStatus	Possible values: `AUTHENTICATED`, `NOT_AUTHENTICATED`, `UNSUPPORTED`, `UNSUPPORTED` means that card does not support 3-D Secure or 3DS authentication process finished with an unknown status.	`Necessity`: Optional `Type`: Enum
randomSumAuthStatus	Possible values: `AUTHENTICATED`, `NOT_AUTHENTICATED`.	`Necessity`: Optional `Type`: Enum

Fail Response Parameters

Parameter Name	Description	Value
error		`Type`: Object
error.cause	Cause of the error. Possible values: `FILTERED`, `INVALID_REQUEST`, `INTERNAL_ERROR`, `PROCESSING_FAILED`, `ORDER_NOT_FOUND`.	`Type`: Enum
error.code	The unique error code.	`Type`: String
error.message	Description of the error.	`Type`: String
invoiceId	Verification transaction identifier.	`Type`: String

Request Example

{
  "session": {
    "accessToken": "string",
    "token": "string"
  }
}

Success Response Example

{
  "bankOrderId": "string",
  "invoiceId": "string",
  "redirectUrl": "string",
  "session": {
    "token": "string"
  },
  "state": "enum"
}

Fail Response Example

{
  "error": {
    "cause": "enum",
    "code": "string",
    "message": "string"
  },
  "invoiceId": "string"
}

Request Builder

Endpoint Id
Invoice Id	Generated by Merchant's server in "Initiate verification"
session.accessToken	Generated by Merchant's server in "Consumer authentication"
session.token	Obtained in "Perform validation" response

Curl for Unix
Curl for Windows