curl --request POST \
  --url https://api.ripio.com/wallet/contacts/ \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'signature: <signature>' \
  --header 'timestamp: <timestamp>' \
  --data '
{
  "type": "crypto",
  "entity_name": "My BTC wallet",
  "network": "bitcoin",
  "currency": "BTC",
  "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
  "otp_code": "123456"
}
'

{
  "error_code": null,
  "message": null,
  "data": {}
}

Contacts

Create External Contact (crypto Or Fiat)

Creates a new contact. The body field type discriminates: crypto saves a crypto address, fiat saves an AR/ARS banking account. Both modes are idempotent — if an equivalent contact already exists it is returned without creating a duplicate.

When type=fiat, only entity_number (CVU/CBU/alias) is accepted.

The otp_code field is required in the request body for both modes.

NOTE: The contact is automatically created as whitelisted, meaning it will not require OTP for operations.

Authorization

Requires a valid API key.

POST

wallet

contacts

curl --request POST \
  --url https://api.ripio.com/wallet/contacts/ \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'signature: <signature>' \
  --header 'timestamp: <timestamp>' \
  --data '
{
  "type": "crypto",
  "entity_name": "My BTC wallet",
  "network": "bitcoin",
  "currency": "BTC",
  "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
  "otp_code": "123456"
}
'

{
  "error_code": null,
  "message": null,
  "data": {}
}

Headers

authorization

string

required

The API key as a string.

signature

string

required

See the Generating Signature section for more details.

timestamp

number

required

A timestamp in milliseconds. See the Timestamp Security section for more details.

timstamp-tolerance

number

An additional, non-required parameter, that you can send to specify the number of milliseconds after the timestamp for the request to be valid. See the Timestamp Security section for more details.

Body

application/json

The body is of type object.

Response

Contact created (or returned if already existed).

error_code

string

required

Example:

null

message

string

required

Example:

null

data

object

required

List External Contacts Delete External Contact

⌘I