API Reference v1.0

Getting started

Generate signature

You need to have these local values for subsequent apiRequest:

const secretKeyString = generateSecretKeyString(createKeyPairObject()) const email = 'example@mail.com' const phone = '+48111222333' const pin = '12345678' let lastUpdateTime = getLastUpdateTime(0) - needs to be updated after every api request

Process of signature generation:

import nacl from 'tweet-nacl-react-native-expo' import { TextEncoderLite as TextEncoder } from 'text-encoder-lite' const signDetached = nacl.sign.detached const signKeyPair = nacl.sign.keyPair type SigningSourceArr = [string, string, string, number, string, string] const createKeyPairObject = signKeyPair const tEnc = () => new TextEncoder() const toHexString = (bytes) => bytes.reduce((str, byte) => str + byte.toString(16).padStart(2, '0'), '') const fromHexString = (hexString) => new Uint8Array(hexString.match(/.{1,2}/g).map((byte) => parseInt(byte, 16))) const getKeyPairFromSecretKeyString = (secretKeyString: string) => signKeyPair.fromSecretKey(fromHexString(secretKeyString)) const getXpkeys = (secretKeyString) => { const keyPairObject = getKeyPairFromSecretKeyString(secretKeyString) const { publicKey } = keyPairObject const Xpkey64 = toHexString(publicKey) const Xpkey32 = Xpkey64.substr(0, 32) const Xpkey16 = Xpkey64.substr(0, 16) return { Xpkey64, Xpkey32, Xpkey16 } } const getLastUpdateTime = (currentlastUpdateTime: number): number => { let Xutime = Math.floor(Date.now() / 1000) if (Xutime <= currentlastUpdateTime) { Xutime = currentlastUpdateTime + 1 } return Xutime } const getDetachedSignature = (signingSourceArr: SigningSourceArr, secretKey: string): string => { const content = tEnc().encode(signingSourceArr.join('^')) const detached = signDetached( content, secretKey, ) return toHexString(detached) } const generateSecretKeyString = (keyPairObject) => toHexString(keyPairObject.secretKey) const getSignature = ({ secretKeyString, email, phone, lastUpdateTime, pin, signingMessage }) => { if (!secretKeyString) { console.error('keyString is empty [get]') return '' } const { Xpkey64 } = getXpkeys(secretKeyString) const signingSourceArr: SigningSourceArr = [Xpkey64, email, phone, lastUpdateTime, pin, signingMessage] const keyPairObject = getKeyPairFromSecretKeyString(secretKeyString) const { secretKey } = keyPairObject return getDetachedSignature(signingSourceArr, secretKey) } const getSignedPayload = ({ secretKeyString, email, phone, lastUpdateTime, pin, signingMessage, apiActionType, payload }) => { const signature = getSignature({ secretKeyString, email, phone, lastUpdateTime, pin, signingMessage }) const { Xpkey64, Xpkey32 } = getXpkeys(secretKeyString) return { method: apiActionType, pkey: apiActionType === 'register' ? Xpkey64 : Xpkey32, utime: lastUpdateTime, sign: signature, pin: pin, ...payload, } }



key
value



method
register


pkey
7306be42943c6b6ffdadec467932c0ce94c04f2873537f3fc477b29544c78fbf


utime
1587112069


sign
e0ae92a46ae1d0c3139afea5d7b9a8bd7487aafbe31864da16edc56681d0074bab52e96bb2eacb5e68eceda4738dceafda0ba8b0de25615dfbe89da5d9672b01


pin
1111


email
smithbioinfo@email.com


phone
+00111222333


trusted
0


fixIp
0

key	value
method	register
pkey	7306be42943c6b6ffdadec467932c0ce94c04f2873537f3fc477b29544c78fbf
utime	1587112069
sign	e0ae92a46ae1d0c3139afea5d7b9a8bd7487aafbe31864da16edc56681d0074bab52e96bb2eacb5e68eceda4738dceafda0ba8b0de25615dfbe89da5d9672b01
pin	1111
email	smithbioinfo@email.com
phone	+00111222333
trusted	0
fixIp	0

{
  "id": "56913",
  "obj_id": "0",
  "task": "register",
  "trusted": "no",
  "description": "Register"
}

POST https://epayblock.com/api/api.php

Parameter	Description	Format
method	Method to dispatch	String
pkey	Public key (64char)	String
utime	Timestamp of the action	Timestamp
sign	Signature	String
pin	Your account PIN	String
email	Email address of account	String
phone	Phone number of account	String
trusted	Type of account	Number
fixIp	fixed device's IP address	Number

Field	Description	Format
id	the account ID	String
obj_id	ID of manipulated object	Number
task	Name of dispatched task	String
trusted	Does action require confirmation	String
description	Description of the task	String

Authentication



key
value



method
login


pkey
9be238470c8ef012205ce766ab23f7b8


utime
1587103994


sign
b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d


pin
1111

key	value
method	login
pkey	9be238470c8ef012205ce766ab23f7b8
utime	1587103994
sign	b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d
pin	1111

{
  "pkey": {
    "id": 22654,
    "born": "2020-03-18 13:52:24.000000",
    "sync": "2020-03-18 13:52:24.000000",
    "fixip": 0,
    "status": "active",
    "fixipip": "0.0.0.0",
    "trusted": 0,
  },
  "profiles": [
    {
      "id": 1,
      "name": "private low risk",
      "risk": "low",
      "status": "active",
      "limitin": 6000,
      "atype": "private",
      "fee_day": 0.00005,
      "fee_month": 10,
      "fee_open": 10,
    }
  ],
  "waiting": [
    {
      "id": 56896,
      "ip": "127.0.0.1",
      "sync": "2020-03-18 13:52:24.000000",
      "task": "change_phone",
      "utime": 1584615566,
      "errors": 0,
      "obj_id": 0,
      "status": "waiting",
      "pkey_id": 22654,
    }
  ],
  "user": {
    "id": 12382,
    "born": "2020-03-18 13:48:02.000000",
    "atype": "local",
    "lastin": 592757,
    "status": "active",
    "lastout": 592759,
    "lastaction": 56896,
  }
  "ibans": [
    {
      "id": 52400,
      "bic": "EPUALT22XXX",
      "born": "2020-03-18 13:48:02.000000",
      "data": null,
      "iban": "LT113350090100022382",
      "name": "d.drozd+1@bioinfo.pl",
      "lastin": 592757,
      "lastout": 592759,
      "official_name": "",
    }
  ],
  "balances": [
    {
      "id": 12468,
      "balance": 70,
      "iban_id": 52400,
      "currency": "EUR",
    }
  ],
  "targets": [
    {
      "id": 92631,
      "bic": "",
      "data": null,
      "iban": "LT113350090100022382",
      "name": "John Smith",
      "email": "j.smith@bioinfo.pl",
      "title": "Epay transfer",
      "status": "active",
      "currency": "EUR",
      "maxamount": 0,
      "balance_id": 12468,
    }
  ],
  "keys": [
    {
      "id": 22654,
      "born": "2020-03-18 13:52:24.000000",
      "pkey": "9be238470c8ef012205ce766ab23f7b836f253c1a43960887c05222da7e201a0",
      "sync": "2020-03-18 13:52:24.000000",
      "status": "active",
      "fixipip": "0.0.0.0",
      "trusted": 0,
      "user_id": 12382,
    }
  ],
  "actions": [
    {
      "id": 56876,
      "ipa": "127.0.0.1",
      "sync": "2020-03-18 13:55:51.000000",
      "task": "register",
      "utime": 1584536151,
      "errors": 0,
      "obj_id": 22654,
      "status": "done",
      "pkey_id": 22654,
    }
  ],
  "actions": [
    {
      "id": 592759,
      "fee": 0,
      "born": "2020-03-18 13:55:51.000000",
      "data": {
        "title": "Epay transfer"
      },
      "sync": "2020-03-19 09:58:57.000000",
      "amount": 10,
      "status": "waiting",
      "to_bic": "",
      "to_iban": "LT113350090100022382",
      "to_name": "Adam Johnson",
      "currency": "EUR",
      "from_bic": "EPUALT22XXX",
      "to_email": "aj@bioinfo.pl",
      "from_iban": "LT113350090100022382",
      "from_name": "a.smith@bioinfo.pl",
      "target_id": 92631,
      "balance_id": 12468,
      "data_title": "Epay transfer",
      "sepa_msgid": "",
      "data_to_iban": null,
      "data_to_name": null,
      "from_official": "",
      "data_from_iban": null,
      "data_from_name": null,
    }
  ]
}

POST https://epayblock.com/api/api.php

Parameter	Description	Format
method	Method to dispatch	String
pkey	First half of public key (32char)	String
utime	Timestamp of the action	Timestamp
sign	Signature	String
pin	Your account PIN	String

Field	Description	Format
pkey	Object of public key's details	Object
pkey.id	ID of public key	Number
pkey.born	Date of key creation	String
pkey.sync	Time of modification in database	String
pkey.fixip	fixed device's IP address	Number
pkey.status	Status of public key	String
pkey.fixipip	fixed device's IP address	String
pkey.trusted	Type of account	Number
profiles	List of available IBAN profiles to purchase	Array
waiting	List of pending actions	Array
waiting[n].id	ID of waiting action	Number
waiting[n].ip	IP address of action dispatcher	String
waiting[n].sync	Time of modification in database	String
waiting[n].task	Task name	String
waiting[n].utime	Timestamp of the action	Timestamp
waiting[n].errors	Number of action's errors	Number
waiting[n].obj_id	ID of manipulated object	Number
waiting[n].status	Status of waiting action	String
waiting[n].pkey_id	ID of dispatcher's public key	Number
user	Object of user's details	Object
user.id	ID of user	Number
user.born	Date of creation	String
user.lastIn	Date of last signing in	Timestamp
user.status	Status of account	String
user.lastOut	Date of last log out	Timestamp
user.lastAction	ID of last dispatched action	Number
ibans	List of IBANs for account	Array
ibans[n].id	ID of IBAN	Number
ibans[n].bic	BIC of IBAN	Number
ibans[n].born	Date of IBAN creation	String
ibans[n].data	undocumented	undocumented
ibans[n].iban	IBAN number	String
ibans[n].name	Name of IBAN owner	String
ibans[n].lastin	undocumented	String
ibans[n].lastout	undocumented	String
ibans[n].official_name	IBAN's official name	String
balances	List of account's balances	Array
balances[n].id	ID of balance	Number
balances[n].balance	Amount in balance	Number
balances[n].ibanId	ID of IBAN	Number
balances[n].currency	Balance currency	String
targets	List of recipients	Array
targets[n].id	ID of target	Number
targets[n].bic	BIC of target	String
targets[n].data	undocumented	undocumented
targets[n].iban	IBAN of target	String
targets[n].name	Name of target	String
targets[n].email	Email address of target	String
targets[n].title	Title of last transfer	String
targets[n].status	Status of target	String
targets[n].currency	Currency of target	String
targets[n].maxAmount	Maximum amount of transfer	Number
targets[n].balance_id	ID of target's balance	Number
keys	List of keys	Array
keys[n].id	ID of key	Number
keys[n].born	Date of key creation	String
keys[n].pkey	Public key	String
keys[n].sync	Time of modification in database	String
keys[n].status	Status of key	String
keys[n].fixipip	fixed device's IP address	String
keys[n].trusted	Type of account	Number
keys[n].user_id	ID of user	Number
actions	Actions	Array
actions[n].id	ID of action	Number
actions[n].ipa	IP address of action dispatcher	String
keys[n].sync	Time of modification in database	String
actions[n].task	Type of task	String
actions[n].utime	Timestamp of the action	Timestamp
actions[n].errors	Number of errors	Number
actions[n].obj_id	ID of manipulated object	Number
actions[n].status	Status of action	String
actions[n].pkey_id	ID of public key	Number
actions	Actions	Array
actions[n].id	ID of action	Number
transactions[n].fee	Fee of the action	String
transactions[n].born	Creation date of the action	String
transactions[n].data	Object with title	Object
transactions[n].sync	Time of modification in database	String
transactions[n].amount	Amount send in the action	String
transactions[n].status	Status of the action	String
transactions[n].to_bic	BIC of receiver	String
transactions[n].to_iban	IBAN of receiver	String
transactions[n].to_name	Email of receiver	String
transactions[n].currency	Currency of action	String
transactions[n].from_bic	BIC of sender	String
transactions[n].to_email	Email address of receiver	String
transactions[n].data_from_iban	IBAN of sender	String
transactions[n].data_from_name	Name of sender	String
transactions[n].target_id	Target ID	String
transactions[n].balance_id	Balance ID	String
transactions[n].data_title	Title of action	String
transactions[n].sepa_msgid	SEPA message ID	String
transactions[n].data_to_iban	IBAN of receiver	String
transactions[n].data_to_name	Name of receiver	String
transactions[n].from_official	Official name of sender	String
transactions[n].data_from_iban	undocumented	String
transactions[n].data_from_name	undocumented	String

Profile

Change Name



key
value



method
change_name


pkey
9be238470c8ef012205ce766ab23f7b8


utime
1587103994


sign
b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d


pin
1111


ibanId
12468


newName
John Smith

key	value
method	change_name
pkey	9be238470c8ef012205ce766ab23f7b8
utime	1587103994
sign	b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d
pin	1111
ibanId	12468
newName	John Smith

{
  "id": "56913",
  "obj_id": "0",
  "task": "change_name",
  "trusted": "no",
  "description": "Change name",
}

This endpoint changes your IBAN account name.

Request

POST https://epayblock.com/api/api.php

Request body form-data

Parameter	Description	Format
method	Method to dispatch	String
pkey	First half of public key (32char)	String
utime	Timestamp of the action	Timestamp
sign	Signature	String
pin	Your account PIN	String
newName	New account name	String

Response

Field	Description	Format
id	the account ID	String
obj_id	ID of manipulated object	Number
task	Name of dispatched task	String
trusted	Does action require confirmation	String
description	Description of the task	String

Change PIN



key
value



method
change_pin


pkey
9be238470c8ef012205ce766ab23f7b8


utime
1587103994


sign
b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d


pin
1111


newPin
0000

key	value
method	change_pin
pkey	9be238470c8ef012205ce766ab23f7b8
utime	1587103994
sign	b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d
pin	1111
newPin	0000

{
  "id": "56913",
  "obj_id": "0",
  "task": "change_pin",
  "trusted": "no",
  "description": "Change pin",
}

This endpoint changes your account PIN.

Request

POST https://epayblock.com/api/api.php

Request body form-data

Parameter	Description	Format
method	Method to dispatch	String
pkey	First half of public key (32char)	String
utime	Timestamp of the action	Timestamp
sign	Signature	String
pin	Your account PIN	String
newPin	New account PIN	String

Response

Field	Description	Format
id	the account ID	String
obj_id	ID of manipulated object	Number
task	Name of dispatched task	String
trusted	Does action require confirmation	String
description	Description of the task	String

Change Phone



key
value



method
change_phone


pkey
9be238470c8ef012205ce766ab23f7b8


utime
1587103994


sign
b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d


pin
1111


newPhone
+00111222333

key	value
method	change_phone
pkey	9be238470c8ef012205ce766ab23f7b8
utime	1587103994
sign	b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d
pin	1111
newPhone	+00111222333

{
  "id": "56913",
  "obj_id": "0",
  "task": "change_phone",
  "trusted": "no",
  "description": "Change phone to +00111222333",
}

This endpoint changes your account phone number.

Request

POST https://epayblock.com/api/api.php

Request body form-data

Parameter	Description	Format
method	Method to dispatch	String
pkey	First half of public key (32char)	String
utime	Timestamp of the action	Timestamp
sign	Signature	String
pin	Your account PIN	String
newPhone	New phone number	String

Response

Field	Description	Format
id	the account ID	String
obj_id	ID of manipulated object	Number
task	Name of dispatched task	String
trusted	Does action require confirmation	String
description	Description of the task	String

Account

Disable Device



key
value



method
del_key


pkey
9be238470c8ef012205ce766ab23f7b8


utime
1587103994


sign
b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d


pin
1111


  keyId
  22665

key	value
method	del_key
pkey	9be238470c8ef012205ce766ab23f7b8
utime	1587103994
sign	b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d
pin	1111
keyId	22665

{
  "id": "56937",
  "obj_id": "22655",
  "task": "del_key",
  "trusted": "yes",
  "description": "Delete device",
}

Request

POST https://epayblock.com/api/api.php

Request body form-data

Parameter	Description	Format
method	Method to dispatch	String
pkey	First half of public key (32char)	String
utime	Timestamp of the action	Timestamp
sign	Signature	String
pin	Your account PIN	String
keyId	Device ID	Number

Response

Field	Description	Format
id	the account ID	String
obj_id	ID of manipulated object	Number
task	Name of dispatched task	String
trusted	Does action require confirmation	String
description	Description of the task	String

Recipients

Add Recipient



key
value



method
add_target


pkey
1279da9afd103c53a22dc1ba60546960


utime
1584538156


sign
95c06670618e91e164695a791bffdc1fed888bd01f753e63954742781f42528d5642dff2f8b5633506181c85b3b7a096d00e23ee58bef6844eed1b991c081205


pin
1111


amount
5


balanceid
12468


newName
John Smith


newName
John Smith


tmail *
smithepayblock@mail.com


iban
LT023350090100022350


newAddress
San Francisco


newCountry
USA


newTitle
My first transaction


amount
0


maxAmount
0

key	value
method	add_target
pkey	1279da9afd103c53a22dc1ba60546960
utime	1584538156
sign	95c06670618e91e164695a791bffdc1fed888bd01f753e63954742781f42528d5642dff2f8b5633506181c85b3b7a096d00e23ee58bef6844eed1b991c081205
pin	1111
amount	5
balanceid	12468
newName	John Smith
newName	John Smith
tmail *	smithepayblock@mail.com
iban	LT023350090100022350
newAddress	San Francisco
newCountry	USA
newTitle	My first transaction
amount	0
maxAmount	0

{
  "id": "56884",
  "obj_id": "92628",
  "obj_data": "592758",
  "task": "add_target"
  "trusted": "no"
  "description": "Add new transfer destination to LT023350090100022350 , monthly limit: 0.00 EUR, and send 5.00 EUR"
}

Request

POST https://epayblock.com/api/api.php

Request body form-data

Parameter	Description	Format
method	Method to dispatch	String
pkey	First half of public key (32char)	String
utime	Timestamp of the action	Timestamp
sign	Signature	String
pin	Your account PIN	String
amount	Sent amount	Number (9 digits in decimal part of number)
balanceId	ID of balance	Number
newName	Name of target	String
tmail *(optional)	Email address of target	String
iban	IBAN of target	String
newAddress	Address of the target	String
newCountry	Alpha-2 country code of the target	String
newTitle	Title of transaction	String
amount	Sent amount	Number
maxAmount	Maximum permitted amount to send	Number

Response

Field	Description	Format
id	ID of action	String
obj_id	ID of manipulated object	Number
obj_data	Additional data for some actions	Number
task	Name of dispatched task	String
trusted	Does action require confirmation	String
description	Description of the task	String

Delete Recipient



key
value



method
del_target


pkey
1279da9afd103c53a22dc1ba60546960


utime
1584538156


sign
95c06670618e91e164695a791bffdc1fed888bd01f753e63954742781f42528d5642dff2f8b5633506181c85b3b7a096d00e23ee58bef6844eed1b991c081205


pin
1111


targetId
92631

key	value
method	del_target
pkey	1279da9afd103c53a22dc1ba60546960
utime	1584538156
sign	95c06670618e91e164695a791bffdc1fed888bd01f753e63954742781f42528d5642dff2f8b5633506181c85b3b7a096d00e23ee58bef6844eed1b991c081205
pin	1111
targetId	92631

{
  "id": "56938",
  "obj_id": "92628",
  "task": "del_target",
  "trusted": "yes",
  "description": "Delete transfer destination",
}

This endpoint deletes a recipient with the given ID.

Request

POST https://epayblock.com/api/api.php

Request body form-data

Parameter	Description	Format
method	Method to dispatch	String
pkey	First half of public key (32char)	String
utime	Timestamp of the action	Timestamp
sign	Signature	String
pin	Your account PIN	String
targetId	ID of recipient	Number

Response

Field	Description	Format
id	ID of action	String
obj_id	ID of manipulated object	Number
task	Name of dispatched task	String
trusted	Does action require confirmation	String
description	Description of the task	String

Transfers

Send Transfer



key
value



method
send_transaction


pkey
9be238470c8ef012205ce766ab23f7b8


utime
1587103994


sign
b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d


pin
1111


targetId
92628


amount
5


  newTitle
  My first transfer

key	value
method	send_transaction
pkey	9be238470c8ef012205ce766ab23f7b8
utime	1587103994
sign	b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d
pin	1111
targetId	92628
amount	5
newTitle	My first transfer

{
  "id": "56884",
  "obj_id": "92628",
  "obj_data": "592758",
  "task": "add_target"
  "trusted": "no"
  "description": "Add new transfer destination to LT023350090100022350 , monthly limit: 0.00 EUR, and send 5.00 EUR"
}

This endpoint sends a new transaction.

Request

POST https://epayblock.com/api/api.php

Request body form-data

Parameter	Description	Format
method	Method to dispatch	String
pkey	First half of public key (32char)	String
utime	Timestamp of the action	Timestamp
sign	Signature	String
pin	Your account PIN	String
targetId	ID of target	Number
amount	Sent amount	String
newTitle	Title of transfer	String

Response

Field	Description	Format
id	the account ID	String
obj_id	ID of manipulated object	Number
obj_data	Additional data for some actions	String
task	Name of dispatched task	String
trusted	Does action require confirmation	String
description	Description of the task	String

Get Transfers



key
value



method
get_transactions


pkey
9be238470c8ef012205ce766ab23f7b8


utime
1587103994


sign
b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d


pin
1111


last
0


balance
0

key	value
method	get_transactions
pkey	9be238470c8ef012205ce766ab23f7b8
utime	1587103994
sign	b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d
pin	1111
last	0
balance	0

{
  "session": 1,
  "transactions": [
    {
      "id": "592757",
      "balance_id": "12468",
      "target_id": "0",
      "amount": "90.000000000",
      "fee": "0.000000000",
      "data": {
        "title": "Epay transfer"
      },
      "status": "done",
      "born": "2020-03-18 13:48:04",
      "sync": "2020-03-18 13:48:04",
      "sepa_msgid": "",
      "data_title": "new transaction",
      "data_from_iban": "LT403350090100022345",
      "data_from_name": "Leszek R",
      "data_to_iban": "d.drozd+1@bioinfo.pl",
      "data_to_name": "Damian Drozd",
      "currency": "EUR",
      "from_official": "",
      "from_name": "",
      "from_bic": "",
      "from_iban": "",
      "to_name": "d.drozd+1@bioinfo.pl",
      "to_bic": "EPUALT22XXX",
      "to_iban": "LT113350090100022382",
      "to_email": ""
    },
    {
      "id": "592756",
      "balance_id": "12468",
      "target_id": "1",
      "amount": "0.000000000",
      "fee": "10.000000000",
      "data": {
        "title": "Account opening fee"
      },
      "status": "done",
      "born": "2020-03-18 13:48:03",
      "sync": "2020-03-18 13:48:03",
      "sepa_msgid": "",
      "data_title": "account opening fee",
      "data_from_iban": null",
      "data_from_name": null,
      "data_to_iban": null,
      "data_to_name": null,
      "currency": "EUR",
      "from_official": "",
      "from_name": "",
      "from_bic": "",
      "from_iban": "",
      "to_name": "d.drozd+1@bioinfo.pl",
      "to_bic": "EPUALT22XXX",
      "to_iban": "LT113350090100022382",
      "to_email": ""
    }
  ]
}

This endpoint retrieves historical transactions.

Request

POST https://epayblock.com/api/api.php

Request body form-data

Parameter	Description	Format
method	Method to dispatch	String
pkey	First half of public key (32char)	String
utime	Timestamp of the action	Timestamp
sign	Signature	String
pin	Your account PIN	String
last	Index of transaction at which to begin extraction	Number
balance	ID of balance	Number

Response

Field	Description	Format
transactions	List of transactions	Array
transactions[n].id	ID of transaction	String
transactions[n].balance_id	ID of transaction's balance	String
transactions[n].target_id	ID of target	String
transactions[n].amount	Amount send in the transaction	String
transactions[n].fee	Fee of the transaction	String
transactions[n].data	Object with data details	Object
transactions[n].data.title	Title of transaction's data	String
transactions[n].status	Status of the transaction	String
transactions[n].born	Creation date of transaction	String
transactions[n].sync	Time of modification in database	String
transactions[n].sepa_msgid	SEPA message ID	String
transactions[n].data_title	Title of the transaction	String
transactions[n].data_from_iban	IBAN of sender	String
transactions[n].data_from_name	Name of sender	String
transactions[n].data_to_iban	IBAN of receiver	String
transactions[n].data_to_name	Name of receiver	String
transactions[n].currency	Currency symbol	String
transactions[n].from_official	Official name of sender	String
transactions[n].from_name	Name of sender	String
transactions[n].from_bic	BIC of sender	String
transactions[n].from_iban	IBAN of sender	String
transactions[n].to_name	Name of receiver	String
transactions[n].to_bic	BIC of receiver	String
transactions[n].to_iban	IBAN of receiver	String
transactions[n].to_email	Email address of receiver	String

Actions

Get Action



key
value



method
get_action


pkey
1279da9afd103c53a22dc1ba60546960


utime
1584538156


sign
95c06670618e91e164695a791bffdc1fed888bd01f753e63954742781f42528d5642dff2f8b5633506181c85b3b7a096d00e23ee58bef6844eed1b991c081205


pin
1111


actionId
92628

key	value
method	get_action
pkey	1279da9afd103c53a22dc1ba60546960
utime	1584538156
sign	95c06670618e91e164695a791bffdc1fed888bd01f753e63954742781f42528d5642dff2f8b5633506181c85b3b7a096d00e23ee58bef6844eed1b991c081205
pin	1111
actionId	92628


{
  "session": 1,
  "actions": [
    {
      "id": "56915",
      "pkey_id": "22654",
      "utime": "1584693374",
      "status": "waiting",
      "task": "change_pin",
      "obj_id": "0",
      "obj_data": "01234",
      "errors": "0",
      "sync": "2020-03-20 09:36:15",
      "ipa": "85.10.198.13",
      "description": "Change pin",
    }
  ]
}

This endpoint retrieves action by ID.

Request

POST https://epayblock.com/api/api.php

Request body form-data

Parameter	Description	Format
method	Method to dispatch	String
pkey	First half of public key (32char)	String
utime	Timestamp of the action	Timestamp
sign	Signature	String
pin	Your account PIN	String
actionId	ID of action to retrieve	Number

Response

Field	Description	Format
id	ID of action	String
pkey_id	ID of public key	Number
utime	Timestamp of the action	Timestamp
status	Status of action	String
task	Description of task	String
obj_id	ID of manipulated object	String
obj_data	Additional data for some actions	String
errors	Errors	String
sync	Time of modification in database	String
ipa	IP address of action dispatcher	String
description	Description of action	String

Cancel Action



key
value



method
cancel


pkey
1279da9afd103c53a22dc1ba60546960


utime
1584538156


sign
95c06670618e91e164695a791bffdc1fed888bd01f753e63954742781f42528d5642dff2f8b5633506181c85b3b7a096d00e23ee58bef6844eed1b991c081205


pin
1111


actionId
0


task
0


objId
0

key	value
method	cancel
pkey	1279da9afd103c53a22dc1ba60546960
utime	1584538156
sign	95c06670618e91e164695a791bffdc1fed888bd01f753e63954742781f42528d5642dff2f8b5633506181c85b3b7a096d00e23ee58bef6844eed1b991c081205
pin	1111
actionId	0
task	0
objId	0

{
  "id": "56913",
  "obj_id": "0",
  "task": "change_phone",
  "trusted": "yes",
  "description": "Cancel action",
  "status": "cancel",
}

This endpoint cancels an action with the given ID.

Request

POST https://epayblock.com/api/api.php

Request body form-data

Parameter	Description	Format
method	Method to dispatch	String
pkey	First half of public key (32char)	String
utime	Timestamp of the action	Timestamp
sign	Signature	String
pin	Your account PIN	String
actionId	ID of action to retrieve	Number
task	ID of task	Number
objId	ID of manipulated object	Number

Response

Field	Description	Format
id	the account ID	String
obj_id	ID of manipulated object	Number
task	Name of dispatched task	String
trusted	Does action require confirmation	String
description	Description of the task	String
status	Status of the action	String

Get Actions



key
value



method
get_actions


pkey
1279da9afd103c53a22dc1ba60546960


utime
1584538156


sign
95c06670618e91e164695a791bffdc1fed888bd01f753e63954742781f42528d5642dff2f8b5633506181c85b3b7a096d00e23ee58bef6844eed1b991c081205


pin
1111


lastId
592759

key	value
method	get_actions
pkey	1279da9afd103c53a22dc1ba60546960
utime	1584538156
sign	95c06670618e91e164695a791bffdc1fed888bd01f753e63954742781f42528d5642dff2f8b5633506181c85b3b7a096d00e23ee58bef6844eed1b991c081205
pin	1111
lastId	592759


{
  "session": 1,
  "actions": [
    {
      "id": "56915",
      "ipa": "127.0.0.1",
      "sync": "2020-03-20 09:36:15",
      "task": "change_pin",
      "utime": "1584693374",
      "errors": "0",
      "obj_id": "0",
      "status": "waiting",
      "pkey_id": "22654"
    },
    {
      "id": "5876",
      "ipa": "127.0.0.1",
      "sync": "2020-03-20 09:36:15",
      "task": "del_target",
      "utime": "1584699147",
      "errors": "0",
      "obj_id": "22654",
      "status": "done",
      "pkey_id": "22654"
    }
  ]
}

Request

POST https://epayblock.com/api/api.php

Request body form-data

Parameter	Description	Format
method	Method to dispatch	String
pkey	First half of public key (32char)	String
utime	Timestamp of the action	Timestamp
sign	Signature	String
pin	Your account PIN	String
lastId	Index at which to begin extraction	Number

Response

Field	Description	Format
actions	List of actions	Array
actions[n].id	ID of action	String
actions[n].ipa	IP address of action dispatcher	String
actions[n].sync	Time of modification in database	String
actions[n].task	Description of task	String
actions[n].utime	Timestamp of the action	Timestamp
actions[n].errors	Errors	String
actions[n].obj_id	ID of manipulated object	String
actions[n].status	Status of action	String
actions[n].pkey_id	ID of public key	Number

Getting started

Generate signature

How to generate signature

You need to have these local values for subsequent apiRequest:

Process of signature generation:

Sign up

Request

Request body form-data

Response

Authentication

Sign in to your Business account

Request

Request body form-data

Response

Profile

Change Name

Request

Request body form-data

Response

Change PIN

Request

Request body form-data

Response

Change Phone

Request

Request body form-data

Response

Account

Disable Device

Request

Request body form-data

Response

Recipients

Add Recipient

Request

Request body form-data

Response

Delete Recipient

Request

Request body form-data

Response

Transfers

Send Transfer

Request

Request body form-data

Response

Get Transfers

Request

Request body form-data

Response

Actions

Get Action

Request

Request body form-data

Response

Cancel Action

Request

Request body form-data

Response

Get Actions

Request

Request body form-data

Response