Skip to main content

Start Payment Request Example

Overview​

This endpoint initiates a card payment request. Based on the response received, the process can either continue with 3D Secure authentication or be completed directly.
Note: For payments requiring 3D Secure authentication, the user must be redirected to the authentication URL.

Sample Code​

Important
  • Set token in instrument if you have a saved payment token; otherwise, fill in the card fields (account, expMonth, expYear, secretCode).
  • emailSubject and cancelUrl are optional, but notifyUrl, redirectUrl, and language are required.
{
"config": {
  "emailTemplate": "confirm",
  "notifyUrl": "http://yourdomain.com/example/ipn.php",
  "redirectUrl": "http://yourdomain.com/example/backUrl.php",
  "language": "en"
},
"payment": {
  "options": {
    "installments": 1,
    "bonus": 0
  },
  "instrument": {
    "type": "card",
    "account": "9900004810225098",
    "expMonth": 1,
    "expYear": 2025,
    "secretCode": "111",
    "token": ""
  }
},
"order": {
  "posSignature": "XXXX-XXXX-XXXX-XXXX",
  "dateTime": "2023-08-24T14:15:22Z",
  "description": "Order Desc",
  "orderID": "stringOrderID12345",
  "amount": 200,
  "currency": "USD",
  "billing": {
    "email": "user@example.com",
    "phone": "+1 555-555-5555",
    "firstName": "John",
    "lastName": "Doe",
    "city": "New York",
    "country": 840,
    "countryName": "United States",
    "state": "NY",
    "postalCode": "10001",
    "details": "123 5th Avenue, Apt 7"
  }
}
}