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.

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

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

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

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

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

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

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