APM API

API Endpoint

Live APIProduction environment

POSThttps://api.thepayment.company/api/v1/live/apm

Test APISandbox environment

POSThttps://api.thepayment.company/api/v1/test/apm

Request Fields

Parameter	Type	Description	Required
`first_name`	String	Given name of the payer	Yes
`last_name`	String	Family name of the payer	Yes
`email`	String	Customer email address	Yes
`address`	String	Billing street address	Yes
`country`	String	Country code in ISO 3166-1 alpha-3 format	Yes
`city`	String	Payer city	Yes
`state`	String	Payer state or region	Yes
`zip`	String	ZIP or postal code	Yes
`ip_address`	String	Customer IP address	Yes
`phone_number`	String	Payer phone number	Yes
`amount`	Number	Payment amount in the smallest currency unit	Yes
`currency`	String	Currency code in ISO 4217 format	Yes
`redirect_url`	String	URL where the customer is sent after payment	Yes
`webhook_url`	String	URL used for server-to-server webhook updates	No
`order_id`	String	Merchant-side unique order reference	No
`terminal_id`	String	Unique connector terminal ID, useful when choosing a primary or fallback connector	No

Payload

Send the request payload as JSON. The sample structure is shown below:

{
"first_name": "James",
"last_name": "Karlo",
"email": "james.karlo@gmail.com",
"address": "Drovers,Llandrindod Wells",
"country": "GB",
"city": "London",
"state": "PW",
"zip": "LD1 5PT",
"ip_address": "127.0.0.1",
"phone_number": "6567453421",
"amount": 10,
"currency": "USD",
"redirect_url": "https://thepayment.company",
"webhook_url": "https://webhook.url",
"order_id": "Te52643",
"terminal_id": "T56353"
}

Sample Responses

{
"status": "REDIRECT",
"message": "Please redirect user to complete the payment.",
"redirect_url": "https://api.thepayment.company/api/v1/test/apm/checkout/AP0186280974141637",
"data": {
  "amount": 10,
  "currency": "USD",
  "order_id": "Te52643",
  "transaction_id": "AP0186280974141637",
  "customer": {
    "first_name": "James",
    "last_name": "Karlo",
    "email": "james.karlo@gmail.com"
  },
  "refund": {
    "status": false,
    "refund_date": null
  },
  "chargeback": {
    "status": false,
    "chargeback_date": null
  }
}
}

Encrypted payment APIs must use AES-256-CBC before transmitting sensitive fields. Authentication, headers, encryption steps, and sample implementations for Node.js, PHP, Python, and Java are documented in Integration Examples.

APM API

API Endpoint

Request Fields

Payload

Sample Responses

Integration Notes

On this page