Create a new Monerium integration

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({signature: '<string>'})
};

fetch('https://api.valox.co/api/v1/integrations/monerium', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "success": true,
    "status": 200,
    "moneriumProfileId": "profile_123456789",
    "iban": "DE44500105175407324931",
    "bic": "GENODEM1GLS"
  }
}

IBAN

Create a new Monerium integration

Creates a new Monerium integration for the authenticated user and associates it with the authenticated user’s EOA address. All operations on Monerium are done through their API, this endpoint is just a way to reuse the KYC to open an account on Monerium.

If the user does not have a Monerium account, this endpoint will create a new one and associate it with the authenticated user’s EOA address.
If the user already has a Monerium account, you do not need to call this endpoint again.

Just use the Monerium API directly to request access to the user’s monerium account. Check their documentation for more information: https://monerium.dev/api-docs/v2

POST

api

integrations

monerium

Create a new Monerium integration

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({signature: '<string>'})
};

fetch('https://api.valox.co/api/v1/integrations/monerium', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "success": true,
    "status": 200,
    "moneriumProfileId": "profile_123456789",
    "iban": "DE44500105175407324931",
    "bic": "GENODEM1GLS"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

signature

string

Signature of the message "I hereby declare that I am the address owner." This signature is created by signing the message with the user's wallet. The exact message can be retrieved from the /api/v1/ibans/signing-message endpoint. The signature is used to verify ownership of the address on Monerium. Format: Ethereum signature string (e.g., "0x1234...").

Response

Successfully created a new Monerium integration

data

object

Show child attributes

data.success

boolean

required

Indicates whether the Monerium integration was successfully created

Example:

true

data.status

number

required

HTTP status code of the operation

Example:

200

data.description

string

required

Human-readable description of the operation result

Example:

"Successfully setup Monerium integration"

data.responseData

object

Raw response data from Monerium API (only present on errors)

data.moneriumProfileId

string | null

The Monerium profile ID assigned to the user (only present on success)

Example:

"profile_123456789"

data.iban

string | null

The assigned IBAN number (only present on success)

Example:

"DE44500105175407324931"

data.bic

string | null

The assigned BIC code (only present on success)

Example:

"GENODEM1GLS"

data.responseHeaders

object

Headers from the Monerium API response (only present on errors)

Example:

{ "content-type": "application/json" }

Get the message that needs to be signed for IBAN activation Retrieve IBAN details

⌘I

Authentication

API reference

PSE API

Create a new Monerium integration

Authorizations

Body

Response