Payment Request with Solution ID

Process a payment through a specific payment solution by providing its unique ID.

Endpoint Information

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

Description

When using solutionUniqueId, the payment will be processed through the specified payment solution only. This bypasses the automatic solution selection logic and forces the transaction to go through the chosen provider.

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",
  "contactNumber": "+12345678",
  "address": "SE",
  "country": "Sweden",
  "zipCode": "1212",
  "currency": "USD",
  "amount": "10.0",
  "ttl": 5,
  "tagName": "VIP Tag",
  "webhookUrl": "https://example.webhook",
  "merchantAccountId": "{{your_account_no}}",
  "solutionUniqueId": [
    "485093e0-2ed6-466a-8573-7ee659db40c5"
  ]
}

Key Parameter

Parameter	Type	Required	Description
solutionUniqueId	array	Yes	Array containing the UUID of the specific payment solution 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"
  }
}

Response Fields

Field	Type	Description
success	boolean	Request success status
message	string	Response message
data.payment_url	string	Payment checkout URL to redirect the customer

Usage

This is useful when:

1. A customer has explicitly chosen a payment method (e.g., "Pay with Trust Payments") on your site.
2. You want to A/B test specific providers.
3. You have business logic determining the specific route for a transaction.

tip

You can get the list of available solution IDs using the Solutions List API.

Example Screenshot

Related Endpoints

• Solutions List - Get available solution IDs
• Payment with Solution Group - Process via a group of solutions