📄 Payments API — Online Payments & Payouts

• APIs that enable clients to securely perform payment operations.

• Base URL: https://dev-payment.msolution.az/eComIntegration

• Authentication:

  • JWT-based mechanism
  • Credentials (username & password) are issued after contract signing
  • Each JWT token can be reused

• Workflow:

  • Token Generation → Authenticate using credentials to obtain JWT
  • Payment Request → Use JWT to initiate a payment request (receive payment page URL)
  • Redirection → User redirected to payment page to enter card details
  • Payment Result → Sent to client via callback URL
  • Manual Status Check → Separate API for checking transaction status

  Sequence Diagram:

  

🔑 Authentication — Retrieve JWT Token

• Description: The login for your server to access the payment system. Send your credentials to get a temporary access token (JWT). You must include this token in the header of all other requests.
• Endpoint: POST /api/v1/auth/authenticate
• Description: Retrieve a JWT token to authorize further requests.
• Request Body:

{
  "userName": "your-user-name",
  "password": "your-password"
}

• Response Example:

{
  "access_token": "eyJhbGciOiJIUzI1NiJ9..."
}

💳 Payment Session — Retrieve Payment Link

• Description: Creates a unique, secure payment page for a customer. By sending order details (amount, order ID), you will get back a payment URL. Send your customer to this URL to enter their card details and pay.