Demo

CoinNexus

Using this API service you can accept payments in Euros from your customers and receive bitcoin in your account.

API credentials

You can use your bitalo login ID and an api specific password to access the gateway.An auto generated password will be emailed to you when you login to the lamium app.You can request for a new API password from the user profile dropdown menu in the lamium app.

Usage

Standard Headers for all request

  • Accept : application/json
  • Content-Type : application/json

Get access token(valid for one hour)

  • Request type : POST
  • Body (raw - JSON(application/json))
  • {"username”:”bitalo_username”,"password”:”api_password“}
  • url : http://api.lamium.fi/api/users/token
  • Successful response format(JSON)
  • {"success": true,"data": {"token": “VgfgnmjkuubrtiJ9.eyGmitum7dsem34lmHbf.BY6N8nyRwXczFVXv45MHOsndnGZpFzsC50WA_6xXVfBFU"}}
  • Unsuccessful response format(JSON)
  • {"message": "Invalid username or password","url": "/api/users/token","code": 401}

Add new payment record

  • Headers
  • Authorization : Bearer access_token
  • Request type : POST
  • Body (raw - JSON(application/json))
  • {"amount”:”1700”,"purchase_bitcoin_agreement":"1","customer_name”:”Full name of the customer”,"customer_address”:”Address of the customer,"customer_email”:”Email address of the customer(optional),"customer_phone”:”Phone number of the customer(optional)}
  • url : http://api.lamium.fi/api/payments/add
  • Successful response format(JSON)
  • {"success": true,"data": [{"message": "payment record added successfully","iban" :"bank iban","bic" :"bank bic","customer_reference": 1490365412,"merchant_id": "bfe2fdc61cd9934b73b8adcb9b888457a679f166207fa0294e902cc4cc%17F%FA%0E%B6%25%EE%3A%EA%13%C0E%89%10%5E%2C%10I%8D%C3%CE%BE%FB4%7C%8F%0B%00G%FD%A0B","transaction_id": "2e3f505d63cef8c5d94b0a49b1d239f17a0a308b312fb45e2a8763842fc6c82d%12%B9%CA%D0%E5%CB%AE%EB%C6%84%9A%7E%D7%C4R%5D%A3%2C%D1%8C%12%05%92%B8%A3%0DbZ%BB%88y%BF","reference_code": "1c757d1bbe13aecd9ac8ba2cdbdb459e182c62e17470bae85161a0bee1b8be4d%A0%89%F5%10%60%EC%0A%EE%D3%8AE1%A3p%F8%9EV%08%F1%CCK0%3E%F1%E3%3A%F4W%26%06%AD%A8->dc61c207fa02d9934b73bfe2fb8adcb9b8f8a679f166ed598884574e902cc4cc%17F%FA%0E%B6%25%EE%3A%EA%13%C0E%89%10%5E%2C%10I%8D%C3%CE%BE%FB4%7C%8F%0B%00G%FD%A0B->dc61c207fa02d9934b73bfe2fb8adcb9b8f8a679f166ed598884574e902cc4cc%17F%FA%0E%B6%25%EE%3A%EA%13%C0E%89%10%5E%2C%10I%8D%C3%CE%BE%FB4%7C%8F%0B%00G%FD%A0B","checksum": 3109494202}]}
  • IBAN and BIC are the bank details where your customers should pay in fiat money for the order
  • Customer Reference is a value to be used by customers during making payment.
  • Merchant Id is a field unique to each merchant.
  • A transaction Id is generated for each new payments unique for a specific payment.
  • Reference Code is the combination of X-Request-ID header value, merchant Id and transaction Id separated by ‘->’
  • Checksum is the cyclic redundancy check value of the Reference Code using the crc32 algorithm(decimal value).

Request payment record status

  • Headers
  • Authorization : Bearer access_token
  • Request type : POST
  • Body (raw - JSON(application/json))
  • {"customer_reference":"1496926558","merchant_id":"bfe2fdc61cd9934b73b8adcb9b888457a679f166207fa0294e902cc4cc%17F%FA%0E%B6%25%EE%3A%EA%13%C0E%89%10%5E%2C%10I%8D%C3%CE%BE%FB4%7C%8F%0B%00G%FD%A0B","transaction_id":"2e3f505d63cef8c5d94b0a49b1d239f17a0a308b312fb45e2a8763842fc6c82d%12%B9%CA%D0%E5%CB%AE%EB%C6%84%9A%7E%D7%C4R%5D%A3%2C%D1%8C%12%05%92%B8%A3%0DbZ%BB%88y%BF"}
  • url : http://api.lamium.fi/api/payments/orderpaymentstatus
  • Successful response format(JSON)
  • { "success": true,"data": [{"customer_reference": 1496926558,"merchant_id": "bfe2fdc61cd9934b73b8adcb9b888457a679f166207fa0294e902cc4cc%17F%FA%0E%B6%25%EE%3A%EA%13%C0E%89%10%5E%2C%10I%8D%C3%CE%BE%FB4%7C%8F%0B%00G%FD%A0B","transaction_id": "2e3f505d63cef8c5d94b0a49b1d239f17a0a308b312fb45e2a8763842fc6c82d%12%B9%CA%D0%E5%CB%AE%EB%C6%84%9A%7E%D7%C4R%5D%A3%2C%D1%8C%12%05%92%B8%A3%0DbZ%BB%88y%BF","reference_code": "1c757d1bbe13aecd9ac8ba2cdbdb459e182c62e17470bae85161a0bee1b8be4d%A0%89%F5%10%60%EC%0A%EE%D3%8AE1%A3p%F8%9EV%08%F1%CCK0%3E%F1%E3%3A%F4W%26%06%AD%A8->dc61c207fa02d9934b73bfe2fb8adcb9b8f8a679f166ed598884574e902cc4cc%17F%FA%0E%B6%25%EE%3A%EA%13%C0E%89%10%5E%2C%10I%8D%C3%CE%BE%FB4%7C%8F%0B%00G%FD%A0B->dc61c207fa02d9934b73bfe2fb8adcb9b8f8a679f166ed598884574e902cc4cc%17F%FA%0E%B6%25%EE%3A%EA%13%C0E%89%10%5E%2C%10I%8D%C3%CE%BE%FB4%7C%8F%0B%00G%FD%A0B","checksum": 4103494403,"amount" : 132,"customer_name":"Full name of the customer","customer_address":"Address of the customer,"customer_email":"Email address of the customer","customer_phone":"Phone number of the customer", "payment_status": "claimed"}]}
  • Customer Reference is a value to be used by customers during making payment.
  • Merchant Id is a field unique to each merchant.
  • A transaction Id is generated for each new payments unique for a specific payment.
  • Reference Code is the combination of X-Request-ID header value, merchant Id and transaction Id separated by ‘->’
  • Checksum is the cyclic redundancy check value of the Reference Code using the crc32 algorithm(decimal value).
  • Statuses and description
    • NEW: the API entry has just been created in the database and no fiat payment recipient has been assigned yet.
    • CLAIMED: the API entry has been assigned to one bank account and the customer can send the fiat payment to that account.
    • FIAT PAID: CoinNexus has received the fiat payment on the assigned bank account. This status is set by CoinNexus when the bank API has detected the incoming payment via the reference number.
    • BTC SENT: CoinNexus has (manuall) sent/released the Bitcoins to the API Client. This setting is set manually in the CoinNexus Admin Panel by an administrator.

Request all payment record statuses

  • Headers
  • Authorization : Bearer access_token
  • Request type : POST
  • Body (raw - JSON(application/json))
  • {"merchant_id":"bfe2fdc61cd9934b73b8adcb9b888457a679f166207fa0294e902cc4cc%17F%FA%0E%B6%25%EE%3A%EA%13%C0E%89%10%5E%2C%10I%8D%C3%CE%BE%FB4%7C%8F%0B%00G%FD%A0B","transaction_ids":["2e3f505d63cef8c5d94b0a49b1d239f17a0a308b312fb45e2a8763842fc6c82d%12%B9%CA%D0%E5%CB%AE%EB%C6%84%9A%7E%D7%C4R%5D%A3%2C%D1%8C%12%05%92%B8%A3%0DbZ%BB%88y%BF"],"statuses":["claimed"],page_no:"number of the page(optional,default is 1. 100 records are returned per request)"}
  • url : http://api.lamium.fi/api/payments/allorderpaymentstatus
  • Successful response format(JSON)
  • {"success": true,"data": [{"0": {"transaction_id":2e3f505d63cef8c5d94b0a49b1d239f17a0a308b312fb45e2a8763842fc6c82d%12%B9%CA%D0%E5%CB%AE%EB%C6%84%9A%7E%D7%C4R%5D%A3%2C%D1%8C%12%05%92%B8%A3%0DbZ%BB%88y%BF","customer_reference": 1496926558,"amount" : 132,"customer_name":"Full name of the customer","customer_address":"Address of the customer,"customer_email":"Email address of the customer","customer_phone":"Phone number of the customer","payment_status": "claimed"},  "merchant_id": "bfe2fdc61cd9934b73b8adcb9b888457a679f166207fa0294e902cc4cc%17F%FA%0E%B6%25%EE%3A%EA%13%C0E%89%10%5E%2C%10I%8D%C3%CE%BE%FB4%7C%8F%0B%00G%FD%A0B","reference_code": "32c757d1bde13aecd9ac8ba2cdbdb459e182c62e17470bae85161a0bee1b8be4d%A0%89%F5%10%60%EC%0A%EE%D3%8AE1%A3p%F8%9EV%08%F1%CCK0%3E%F1%E3%3A%F4W%26%06%AD%A8->dc61c207fa02d9934b73bfe2fb8adcb9b8f8a679f166ed598884574e902cc4cc%17F%FA%0E%B6%25%EE%3A%EA%13%C0E%89%10%5E%2C%10I%8D%C3%CE%BE%FB4%7C%8F%0B%00G%FD%A0B->dc61c207fa02d9934b73bfe2fb8adcb9b8f8a679f166ed598884574e902cc4cc%17F%FA%0E%B6%25%EE%3A%EA%13%C0E%89%10%5E%2C%10I%8D%C3%CE%BE%FB4%7C%8F%0B%00G%FD%A0B","checksum": 4340349455}]}
  • Merchant Id is a field unique to each merchant.
  • Multiple transaction ids and statues can be sent(optional fields)
  • Transaction ids are only returned in the result data set if transaction ids were sent in the request,for calls without transaction id,customer_reference can be used as a unique value reference
  • Reference Code is the combination of X-Request-ID header value and merchant Id separated by ‘->’
  • Checksum is the cyclic redundancy check value of the Reference Code using the crc32 algorithm(decimal value).
  • Statuses and description
    • NEW: the API entry has just been created in the database and no fiat payment recipient has been assigned yet.
    • CLAIMED: the API entry has been assigned to one bank account and the customer can send the fiat payment to that account.
    • FIAT PAID: CoinNexus has received the fiat payment on the assigned bank account. This status is set by CoinNexus when the bank API has detected the incoming payment via the reference number.
    • BTC SENT: CoinNexus has (manuall) sent/released the Bitcoins to the API Client. This setting is set manually in the CoinNexus Admin Panel by an administrator.