Attach KYC

Attach or update Know Your Customer (KYC) documents for a customer.

Endpoint

PUT https://api-v3.reeple.ai/customers/{id}/attach

Parameter	Type	Description
`id`	String	Required. The unique identifier of the customer account to update.

Request body

Field	Type	Description
`idType`	Enum	Required. `NIN`, `PASSPORT`, `DRIVER_LICENSE`, or `VOTER_CARD`.
`idNumber`	String	Required if `idType` is provided. Identification document number.
`document`	String	Required if `idType` is provided. URL to the user’s identification document.
`profileImage`	String	Required if `idType` is provided. URL to the user’s profile image.
`bvn`	String	Conditionally required. Required when the customer’s country is `NG`.
`dateOfBirth`	String	Optional. `YYYY-MM-DD`.

Country and currency support

This endpoint isn’t tied to a single transaction currency — it applies to customer identity verification across customer-linked flows.

Requirement	Applies
BVN	Required when the customer country is `NG`
Identity document and profile image	Required when customer identity data is being attached for verification

KYC and AML requirements

Requirement	Applies	Notes
Customer identity document	Yes	Required when attaching or updating KYC
Country-specific identity rules	Yes	Nigeria requires BVN in the documented flow
AML review	Conditional	KYC quality affects whether downstream products can be issued or funded

Response

{
  "success": true,
  "statusCode": 200,
  "message": "Customer created successfully",
  "data": {
    "id": "326a18a1-441a-457d-ba28-0538e0717c92",
    "email": "test@example.com",
    "firstName": "test",
    "lastName": "testing",
    "city": "Bariga",
    "state": "Lagos",
    "country": "Nigeria",
    "zipCode": "100231",
    "line1": "123, Example road",
    "line2": null,
    "phoneNumber": "+2348131911964",
    "house": "Zk9",
    "dateOfBirth": "2002-10-29T00:00:00.000Z",
    "idType": "NIN",
    "idNumber": "123456789",
    "document": "https://example.com/document.pdf",
    "imageURL": "https://example.com/profile.jpg",
    "reference": "w72hs8shshshshw8s8292ushs",
    "createdAt": "2024-05-01T22:10:44.329Z",
    "status": "REJECTED",
    "reason": "Utility bill is older than 3 months",
    "businessId": "0bb1dfc6-a74c-4e53-b41a-4a0c1eab188e"
  }
}

Save the returned customer id — you’ll need it for bank account issuance, tuition payments, and other customer-linked endpoints.

Common errors

Status	Meaning
`422`	Insufficient balance

Get Started

Bank Accounts

Bill Payments

Collections

Compliance

Customer

External Services

Gift Cards

Payment Links

Payouts

Refunds

S2S Payments

Transactions

Tuition

Endpoint

Request body

Country and currency support

KYC and AML requirements

Response

Common errors

​Endpoint

​Request body

​Country and currency support

​KYC and AML requirements

​Response

​Common errors

Endpoint

Request body

Country and currency support

KYC and AML requirements

Response

Common errors