Check transfer

Introduction

Check transfer is initiated through HTTPS POST request by using URLs and the parameters.
Check transfer is used for security purposes and allows Billblend to compare the data sent by Connecting Party’s app with the data stored on Connecting Party’s server.
It is highly recommended to respond with the actual information stored on Connecting Party’s server.

API URLs

Connecting Party Server

https://proxy.connectingpartyserver.com/transfer/{invoiceId}/check

Request Parameters

Parameter Name

Description

Value

consumer


Necessity: Required
Type: Object

consumer.device


Necessity: Required
Type: Object

consumer.device.serialNumber

Consumer’s device serial number.

Necessity: Required
Type: String
Length: 1-50

session


Necessity: Required
Type: Object

session.accessToken

Consumer’s access token key sent by Connecting Party’s app.

Necessity: Required
Type: String
Length: 32-128

session.nonce

Value sent by Connecting Party’s app.

Necessity: Required
Type: String
Length: 32-128

session.signature

Value sent by Connecting Party’s app.

Necessity: Required
Type: String
Length: 32-128

session.token

The session token of transfer transaction.

Necessity: Required
Type: String
Length: 16-36

sourceOfFunds

Necessity: Optional
Type: Object

sourceOfFunds.reference

Necessity: Optional
Type: Object

sourceOfFunds.reference.clientCardId

The source card reference identifier (on client side) if sent in Perform Transfer request.

Necessity: Optional
Type: String
Length: 1-128

destinationOfFunds

Necessity: Optional
Type: Object

destinationOfFunds.reference

Necessity: Optional
Type: Object

destinationOfFunds.reference.clientCardId

The destination card reference identifier (on client side) if sent in Perform Transfer request.

Necessity: Optional
Type: String
Length: 1-128

Success Response Parameters

Parameter Name

Description

Value

invoiceId

Transfer transaction identifier.

Necessity: Required
Type: String

session


Necessity: Required
Type: Object

session.checkSignature

Checksum generated by hmac-sha1 (see Signature computation) from the concatenation of the consumer.device.serialNumber, session.nonce, destinationOfFunds.reference.serverCardId (if present), endpointId, invoiceId, sourceOfFunds.reference.serverCardId (if present).

Necessity: Required
Type: String

session.nonce

Unique random string generated by Connecting Party’s server in Initiate transfer response.

Necessity: Required
Type: String

session.token

The session token of transfer transaction.

Necessity: Required
Type: String

consumer.email

Consumer’s email address.

Necessity: Optional
Type: String

destinationOfFunds

Necessity: Optional
Type: Object

destinationOfFunds.reference

Necessity: Optional
Type: Object

destinationOfFunds.reference.serverCardId

The destination card reference identifier (on server side).

Necessity: Optional
Type: String

sourceOfFunds

Necessity: Optional
Type: Object

sourceOfFunds.reference

Necessity: Optional
Type: Object

sourceOfFunds.reference.serverCardId

The source card reference identifier (on server side).

Necessity: Optional
Type: String

transaction.currency

Upper case letters (ISO 4217 alpha code).

Necessity: Optional
Type: String

transaction.randomSumCentis

Random sum amount (for random sum check), 1.00 EUR = 100 centis.

Necessity: Optional
Type: Integer

Fail Response Parameters

Parameter Name

Description

Value

error

Type: Object

error.cause

Cause of the error. Possible values: FILTERED, INVALID_REQUEST, SERVER_FAILED, SERVER_UNAVAILABLE.

Type: Enum

error.code

The unique error code.

Type: String

error.message

Description of the error.

Type: String

invoiceId

Transfer transaction identifier.

Type: String

Request Example

{
  "consumer": {
    "device": {
      "serialNumber": "string"
    }
  },
  "destinationOfFunds": {
    "reference": {
      "clientCardId": "string"
    }
  },
  "session": {
    "accessToken": "string",
    "nonce": "string",
    "signature": "string",
    "token": "string"
  },
  "sourceOfFunds": {
    "reference": {
      "clientCardId": "string"
    }
  }
}

Success Response Example

{
  "consumer": {
    "email": "string"
  },
  "destinationOfFunds": {
    "card": {
      "number": "string"
    },
    "reference": {
      "serverCardId": "string"
    }
  },
  "invoiceId": "string",
  "session": {
    "checkSignature": "string",
    "nonce": "string",
    "token": "string"
  },
  "sourceOfFunds": {
    "card": {
      "expiry": {
        "month": "integer",
        "year": "integer"
      },
      "holder":{
        "firstName": "string",
        "lastName": "string"
      },
      "number": "string"
    },
    "reference": {
      "serverCardId": "string",
    }
  },
  "transaction": {
    "currency": "string",
    "randomSumCentis": "integer"
  }
}

Fail Response Example

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