Getting started
Generate signature
How to 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,
}
}
Sign up
Request body form-data
key
value
method
register
pkey
7306be42943c6b6ffdadec467932c0ce94c04f2873537f3fc477b29544c78fbf
utime
1587112069
sign
e0ae92a46ae1d0c3139afea5d7b9a8bd7487aafbe31864da16edc56681d0074bab52e96bb2eacb5e68eceda4738dceafda0ba8b0de25615dfbe89da5d9672b01
pin
1111
email
smithbioinfo@email.com
phone
+00111222333
trusted
0
fixIp
0
Response
{
"id": "56913",
"obj_id": "0",
"task": "register",
"trusted": "no",
"description": "Register"
}
Request
POST https://epayblock.com/api/api.php
Request body form-data
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 address of account | String | |
phone | Phone number of account | String |
trusted | Type of account | Number |
fixIp | fixed device's IP address | 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 |
Authentication
Sign in to your Business account
Request body form-data
key
value
method
login
pkey
9be238470c8ef012205ce766ab23f7b8
utime
1587103994
sign
b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d
pin
1111
Response
{
"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,
}
]
}
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 |
Response
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
Request body form-data
key
value
method
change_name
pkey
9be238470c8ef012205ce766ab23f7b8
utime
1587103994
sign
b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d
pin
1111
ibanId
12468
newName
John Smith
Response
{
"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
Request body form-data
key
value
method
change_pin
pkey
9be238470c8ef012205ce766ab23f7b8
utime
1587103994
sign
b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d
pin
1111
newPin
0000
Response
{
"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
Request body form-data
key
value
method
change_phone
pkey
9be238470c8ef012205ce766ab23f7b8
utime
1587103994
sign
b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d
pin
1111
newPhone
+00111222333
Response
{
"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
Request body form-data
key
value
method
del_key
pkey
9be238470c8ef012205ce766ab23f7b8
utime
1587103994
sign
b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d
pin
1111
keyId
22665
Response
{
"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
Request body form-data
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
Request body form-data
key
value
method
del_target
pkey
1279da9afd103c53a22dc1ba60546960
utime
1584538156
sign
95c06670618e91e164695a791bffdc1fed888bd01f753e63954742781f42528d5642dff2f8b5633506181c85b3b7a096d00e23ee58bef6844eed1b991c081205
pin
1111
targetId
92631
Response
{
"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
Request body form-data
key
value
method
send_transaction
pkey
9be238470c8ef012205ce766ab23f7b8
utime
1587103994
sign
b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d
pin
1111
targetId
92628
amount
5
newTitle
My first transfer
Response
{
"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
Request body form-data
key
value
method
get_transactions
pkey
9be238470c8ef012205ce766ab23f7b8
utime
1587103994
sign
b5afffd2effe07da03565dc52a2caff3bc62a9a8b00d8c11493bf2acf58f119b42b983dfe9b6b80555018ec059bdd4b289c55217e47709311688c5c9024ff60d
pin
1111
last
0
balance
0
Response
{
"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
Request body form-data
key
value
method
get_action
pkey
1279da9afd103c53a22dc1ba60546960
utime
1584538156
sign
95c06670618e91e164695a791bffdc1fed888bd01f753e63954742781f42528d5642dff2f8b5633506181c85b3b7a096d00e23ee58bef6844eed1b991c081205
pin
1111
actionId
92628
Response
{
"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
Request body form-data
key
value
method
cancel
pkey
1279da9afd103c53a22dc1ba60546960
utime
1584538156
sign
95c06670618e91e164695a791bffdc1fed888bd01f753e63954742781f42528d5642dff2f8b5633506181c85b3b7a096d00e23ee58bef6844eed1b991c081205
pin
1111
actionId
0
task
0
objId
0
Response
{
"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
Request body form-data
key
value
method
get_actions
pkey
1279da9afd103c53a22dc1ba60546960
utime
1584538156
sign
95c06670618e91e164695a791bffdc1fed888bd01f753e63954742781f42528d5642dff2f8b5633506181c85b3b7a096d00e23ee58bef6844eed1b991c081205
pin
1111
lastId
592759
Response
{
"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 |