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: RequiredType: Object
session.accessToken	The access token key received in Optional consumer authentication.	Necessity: RequiredType: StringLength: 32-128
session.token	The session token of verification transaction.	Necessity: RequiredType: StringLength: 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: ConditionalType: StringLength: 128
redirectUrl	Required if state is REDIRECT_REQUEST.	Necessity: ConditionalType: StringLength: 128
errorCode	Decline reason code, may present if state is DECLINED.	Necessity: OptionalType: IntegerLength: 128
errorMessage	Decline reason message, may present if state is DECLINED.	Necessity: OptionalType: StringLength: 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: OptionalType: Enum
randomSumAuthStatus	Possible values: AUTHENTICATED, NOT_AUTHENTICATED.	Necessity: OptionalType: 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

Request Builder is available at this link – https://doc.billblend.com/integration/API_commands/api_mobile_device/api_verification_status.html#request-builder