Skip to main content
POST
Verify Contact
Use this endpoint when your agent handles email or phone verification independently, instead of having RemitJunction send the verification link or OTP to the customer. Calling this endpoint marks the outstanding email or phone KYC requirement as fulfilled and triggers the full KYC lifecycle automatically — including risk score adjustment, compliance decision re-evaluation, and account approval if all requirements are met.

When to Use This Endpoint

This endpoint is relevant when your agent has one or both of the following settings enabled on the agent configuration: If neither setting is enabled, RemitJunction sends the verification automatically when you call Initiate Compliance Action and this endpoint is not needed.

Request Parameters

Response

The response data object contains the verification result:

Behaviour

When this endpoint is called:
  1. RemitJunction locates the outstanding KYC requirement for the specified userId and contact type.
  2. The requirement is marked as fulfilled.
  3. The customer’s risk score is updated to reflect the completed requirement.
  4. The compliance decision is re-evaluated against the configured thresholds.
  5. If the customer meets the approval threshold, their account is confirmed automatically.
If no outstanding requirement is found for the given userId and type, the call succeeds but no KYC action is taken.

Headers

platform
string
default:fincode
required
uuid
string
default:200
required
X-Auth-Token
string
required

Authentication token for the API request

Query Parameters

userId
string
required

The customer's userId returned from the register-customer endpoint

type
enum<string>
required

The contact type to mark as verified

Available options:
EMAIL,
PHONE_NUMBER

Response

Contact verification processed successfully

status
string
Example:

"SUCCESS"

message
string
Example:

"Contact verified successfully."

data
object