Paymish Loading Docs Preparing guides, collections, and live API references...
Paymish Docs

get discount codes .

Endpoint Overview

POST /api/payment-service/external/v1/products/verify-discount-code

Purpose

Use this endpoint to get discount codes . It belongs to the Products collection and is designed for backend integrations.

Request shape

1 parameter and 1 documented body field using application/json.

Implementation Guide

Recommended workflow

1

Validate the input data, identifiers, and account state in your application before making the request.

2

Send the POST request from your backend using the required headers and the expected content type (application/json).

3

Persist the important identifiers returned in the response so later lookups, webhooks, or support actions can be linked correctly.

Implementation notes

  • Validate and encode query parameters before sending them so filters and pagination behave predictably.
  • Validate the request payload on your backend before sending it, especially the 1 documented body field.
  • Protect state-changing operations with strong validation, logging, and retry rules to avoid duplicate mutations.

Query Parameters

productId
string
product id

Request Body

Content type: application/json

code required
string
Discount code to verify

Responses

200 get products
400 Bad request

Expected Outcomes

200

Success example

get products

Representative Response
{
  "status": "success",
  "message": "Request processed successfully",
  "data": {
    "reference": "PM-REF-12345"
  }
}
400

Failure example

Bad request

Representative Error
{
  "status": "error",
  "message": "Invalid request payload. Check `code` and try again.",
  "errors": {
    "code": [
      "`code` is required."
    ]
  }
}
After the response:
  • Log the Paymish reference or request context returned by the API so support teams can trace the call later.
  • Retry only when the failure is safe to repeat; otherwise correct the payload or auth state first.
  • Store enough internal metadata to match the API response back to your order, payout, case, or checkout record.

Language Notes

Python

Use `requests` from a backend worker, service, or Django/Flask app and centralize headers in a reusable helper.

Node.js

Use `axios` or `fetch` from Node.js services only; do not place secret credentials in frontend bundles.

PHP

Wrap cURL usage in a small client class so auth headers, error handling, and logging stay consistent.

cURL

Use cURL for smoke testing and debugging, then move the final logic into your backend service code.

Code Examples

Python
import requests

headers = {
    "Content-Type": "application/json",
}
payload = {
  "code": "value"
}

response = requests.post(
    "https://api.paymish.com/api/payment-service/external/v1/products/verify-discount-code",
    headers=headers,
    json=payload,
)

data = response.json()
print(data)
Node.js
const axios = require("axios");

const response = await axios({
  method: "post",
  url: "https://api.paymish.com/api/payment-service/external/v1/products/verify-discount-code",
  headers: {
    "Content-Type": "application/json",
  },
  data: {
  "code": "value"
}
});

console.log(response.data);
cURL
curl https://api.paymish.com/api/payment-service/external/v1/products/verify-discount-code \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{   "code": "value" }'
PHP
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.paymish.com/api/payment-service/external/v1/products/verify-discount-code");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    "code" => "value",
]));

$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);