Contact

Resend Contact Verification

This API allows merchants to trigger a re-sending of the identity verification link to a previously created contact. This is useful when the original verification email or SMS was not received, has expired, or the contact needs to restart the verification flow.

The verification link is delivered to the channel specified by resend_to:

email: the verification link is emailed to the contact’s registered email address.
phone: the verification link is sent via SMS to the contact’s registered phone number.

The contact must already exist for the merchant (i.e. previously created via Create contact) before this API can be called.

POST

contacts

resend_verification

Resend Contact Verification

curl --request POST \
  --url https://api.cleverhub.co/api/v2/contacts/resend_verification \
  --header 'Content-Type: application/json' \
  --header 'app-id: <api-key>' \
  --header 'secret-key: <api-key>' \
  --data '
{
  "email": "test@example.com",
  "resend_to": "email"
}
'

import requests

url = "https://api.cleverhub.co/api/v2/contacts/resend_verification"

payload = {
    "email": "test@example.com",
    "resend_to": "email"
}
headers = {
    "app-id": "<api-key>",
    "secret-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'app-id': '<api-key>',
    'secret-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({email: 'test@example.com', resend_to: 'email'})
};

fetch('https://api.cleverhub.co/api/v2/contacts/resend_verification', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cleverhub.co/api/v2/contacts/resend_verification",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'email' => 'test@example.com',
    'resend_to' => 'email'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "app-id: <api-key>",
    "secret-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cleverhub.co/api/v2/contacts/resend_verification"

	payload := strings.NewReader("{\n  \"email\": \"test@example.com\",\n  \"resend_to\": \"email\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("app-id", "<api-key>")
	req.Header.Add("secret-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.cleverhub.co/api/v2/contacts/resend_verification")
  .header("app-id", "<api-key>")
  .header("secret-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"test@example.com\",\n  \"resend_to\": \"email\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cleverhub.co/api/v2/contacts/resend_verification")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["app-id"] = '<api-key>'
request["secret-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"test@example.com\",\n  \"resend_to\": \"email\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "Ok",
  "data": {
    "message": "Email verification link sent",
    "code": "LINK_SENT"
  }
}

Authorizations

app-id

string

header

required

A unique identifier assigned to each application.

secret-key

string

header

required

A secure token associated with the app-id.

Body

application/json

string

required

The contact's email used to look up the record on the merchant's account.

resend_to

enum<string>

required

The delivery channel to resend the verification link to.

email: send the verification link to the contact's email.
phone: send the verification link to the contact's phone.

Available options:

email,

phone

Callbacks

POST

{$request.body#/endpoint_url}KYCStatusChanged

Body

application/json

string

Contact's email

first_name

string

Contact's first name

last_name

string

Contact's last name

type

enum<string>

The type of contact (e.g., individual or organization)

Available options:

individual,

organization

Example:

"individual"

dob

string

Contact date of birth format 'yyyy-mm-dd'

phone

string

Contact's phone

Example:

"+61-412345678"

reg_no

string

Contact registration number.

gender

enum<string>

Contact's gender

Available options:

male,

female

Example:

"male"

street

string

The primary name of an address's street.

city

string

Name of an address's city or town.

postal_code

string

The address's postcode

state

string

The address's state / province / county.

country

string

ISO 3166-1 alpha-2 country code.

identity

object

Contains the most recent KYC submission details for the contact.

Show child attributes

kyc_statuses

object[]

An array of KYC statuses for the contact, containing multiple KYC instances with status and message.

Show child attributes

Response

200

The merchant's server should return this code

Response

Verification link or code sent successfully.

status

string

data

object

Show child attributes

⌘I

Resend Contact Verification

curl --request POST \
  --url https://api.cleverhub.co/api/v2/contacts/resend_verification \
  --header 'Content-Type: application/json' \
  --header 'app-id: <api-key>' \
  --header 'secret-key: <api-key>' \
  --data '
{
  "email": "test@example.com",
  "resend_to": "email"
}
'

import requests

url = "https://api.cleverhub.co/api/v2/contacts/resend_verification"

payload = {
    "email": "test@example.com",
    "resend_to": "email"
}
headers = {
    "app-id": "<api-key>",
    "secret-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'app-id': '<api-key>',
    'secret-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({email: 'test@example.com', resend_to: 'email'})
};

fetch('https://api.cleverhub.co/api/v2/contacts/resend_verification', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cleverhub.co/api/v2/contacts/resend_verification",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'email' => 'test@example.com',
    'resend_to' => 'email'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "app-id: <api-key>",
    "secret-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cleverhub.co/api/v2/contacts/resend_verification"

	payload := strings.NewReader("{\n  \"email\": \"test@example.com\",\n  \"resend_to\": \"email\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("app-id", "<api-key>")
	req.Header.Add("secret-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.cleverhub.co/api/v2/contacts/resend_verification")
  .header("app-id", "<api-key>")
  .header("secret-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"test@example.com\",\n  \"resend_to\": \"email\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cleverhub.co/api/v2/contacts/resend_verification")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["app-id"] = '<api-key>'
request["secret-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"test@example.com\",\n  \"resend_to\": \"email\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "Ok",
  "data": {
    "message": "Email verification link sent",
    "code": "LINK_SENT"
  }
}

Basics

Payment Gateway (AUD)

Multi-Currency Payment API

Payment Gateway 3

Card API

Cashback API

Resend Contact Verification

Authorizations

Body

Callbacks

Body

Response

Response