Add Customer

Endpoint (Requires Authentication)

POST /api/v1/connected-banking/public/upi-collection/customers

This API endpoint is used to add a new customer under UPI Collections. Clients must encrypt their data using the method described above before sending it to the server. The encrypted data should be base64-encoded for safe transmission.

Request Headers

Content-Type: application/json
Authorization: Bearer <jwt_token>

Required Fields

The following fields must be encrypted before being sent to the server:

Note: pan and aadhaar are optional fields — include either, both, or neither depending on the KYC information available for the customer.

Sample Request Body (Encrypted Data)

{
  "payload": "0AkizSTHFK96vJLuQql4/Ln2R0evKIeTLc7kNPX9...encrypted_payload_here"
}

Decrypted Payload Structure

{
  "name": "john doe",
  "enableUpi": true,
  "enableVam": true,
  "pan": "ABCDE1234F",
  "aadhaar": "123456789012",
  "dailyLimit": 10000
}

Success Response (Encrypted) (200 OK)

{
  "respCode": 2004,
  "respMessage": "Customer created successfully",
  "data": "6Cg+4rSLEiN1fFBC97rflSw6eYnFszqMYAj....encrypted_data_here"
}

Decrypted Response

{
  "custId": "828668227300009",
  "name": "john doe",
  "upiEnabled": true,
  "vamEnabled": true,
  "status": 1,
  "vaN": "98852040000001"
}

All Response Codes