Skip to main content

Payment Request with Solution Group

Process a payment through a specific solution group.

Endpoint Information​

Name: Payment Request with Solution Group UUID
Method: POST
URL: {{BASE_URL}}/api/v1/payment/request

Description​

When using solutionGroupUuid, the payment will be processed through the specified solution group only. The system will select the best available solution within that group based on routing rules.

Authentication​

Type: Basic Auth

  • Username: App Key
  • Password: Secret Key

Request Body​

Content-Type: application/json

{
  "firstName": "John",
  "middleName": "",  // optional
  "lastName": "Doe",
  "reference": "DuqXNBv0Q-sk-16",
  "email": "[email protected]",
  "dob": "1990-01-01",  // optional but format must be yyyy-mm-dd if present
  "contactNumber": "+12345678",
  "address": "SE",
  "country": "Sweden",
  "zipCode": "1212",
  "currency": "USD",
  "amount": "10.0",
  "ttl": 5,  // optional
  "tagName": "VIP Tag",  // optional
  "webhookUrl": "https://example.webhook",  // optional, max 255 characters
  "merchantAccountId": "{{your_account_no}}",
  "solutionGroupUuid": "485093e0-2ed6-466a-8573-7ee659db40c5"
}

Key Parameter​

ParameterTypeRequiredDescription
solutionGroupUuidstringYesThe UUID of the solution group to use

All other parameters are the same as the standard Payment Request.

Response​

Success Response​

{
"success": true,
"message": "Payment Request Accepted",
"data": {
  "payment_url": "https://staging.paymid.com/secure-payment/2bfec39f-55dc-4f48-976b-9d37b1675007"
}
}

Usage​

This is useful for:

  1. Routing payments to specific categories (e.g., "VIP Group", "High Risk Group").
  2. Managing different regional groups without selecting specific providers.
tip

You can get the list of available solution group UUIDs using the Solution Groups List API.

Example Screenshot​

Payment with Solution Group