X-Pay Merchant Public Api
  1. XPayMerchant Public API
X-Pay Merchant Public Api
  • Payments
    • Introduction to the X-Pay API
    • Integration Guide - Quick Start
    • Integration Guide - Payments
    • X-Pay WooCommerce
    • X-Pay Flutter Plugin
    • .NET SDK
  • XPayMerchant Public API
    • Get Token Sandbox
      POST
    • Get Token Production
      POST
    • Get Currencies
      GET
    • Get Banks
      GET
    • Get Payment intervals
      GET
    • Payment Calculator
      POST
    • Test Webhook Sandbox
      POST
    • Test Webhook Production
      POST
    • Pay Visa Sandbox
      POST
    • Pay Visa Production
      POST
    • Pay Mastercard Sandbox
      POST
    • Pay Mastercard Production
      POST
    • Pay Mastercard Sandbox Bulk
      POST
    • Pay Mastercard Production Bulk
      POST
    • Pay Visa Sandbox Bulk
      POST
    • Pay Visa Production Bulk
      POST
    • Payment Status Visa Sandbox
      GET
    • Payment Status MasterCard Sandbox
      GET
    • Payment Status Visa Production
      GET
    • Payment Status Mastercard Production
      GET
    • Generate Payment Token Sandbox
      POST
    • Generate Payment Token Production
      POST
    • Card Token Payment Sandbox
      POST
    • Card Token Payment Production
      POST
    • Delete Card Token Sandbox
      DELETE
    • Fast Checkout
      POST
    • Fast Checkout Sandbox
      POST
  1. XPayMerchant Public API

Generate Payment Token Sandbox

POST
/sandbox/api/requestPaymentToken

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Examples

Responses

🟢200Generate Payment Token Sandbox
text/plain
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/sandbox/api/requestPaymentToken' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "merchantId": "311722504951049",
    "paymentTokenReferenceRequest": "TokenForMbano001",
    "transactionsTokenCustomerName": "Udean",
    "transactionsTokenCustomerSurname": "Mbano",
    "transactionsTokenCustomerNumber": "631374774744",
    "paymentTokenMethodName": "Visa",
    "paymentTokenExpiryDate": "012028",
    "paymentTokenCardNumber": "4456530000001005"
}'
Response Response Example
{
    "checkOutStatus": "Success",
    "checkOutId": "1",
    "checkOutReference": "TokenForMbano001",
    "checkOutToken": "18665470510"
}
Modified at 2025-11-17 18:54:15
Previous
Payment Status Mastercard Production
Next
Generate Payment Token Production
Built with