SPEI (MXN)¶

Initial request¶

The request contains certain fields:¶

Field	Description
`order`	transaction number in the merchant system;
`amount`	transaction amount in the currency, separator character is a point “.”;
`currency`	transaction currency, can be MXN;
`user_id`	client identifier in the merchant's system (the field is not required);
`first_name`	customer’s name. Maximum length is 30 characters (Only latin chars are available);
`last_name`	customer’s surname (Only latin chars are available).

The fields process_url, success_url, fail_url (where the client will be redirected after the payment will be redirected to after the payment is made) do not have to be passed. These data are automatically taken from merchant settings in your personal cabinet.

Important

The query strings must contain only Latin letters and numbers.

GET /payment/form

https://<provided url>
/payment/form

Example:

application/json

{
  "order": "0001",
  "amount": "16",
  "currency": "MXN",
  "user_id": "492235",
  "first_name": "IVAN",
  "last_name": "IVANOV"
}

Customer redirection after making a payment¶

Warning

Direction of the buyer to success_url or fail_url is only informational and CAN NOT confirm the success or rejection of payment!

After making a payment, the customer is redirected to success_url or fail_url.

The response contains the fields:¶

Field	Description
`order_no`	transaction number in the merchant system (the same as in the `order` request);
`amount`	transaction amount in the currency, separator character is a point “.”;
`currency_code`	transaction currency (in which the invoice was formed);
`item_name`	goods name (if it was transferred);
`co_inv_id`	unique transaction number;
`co_inv_st`	transaction status in the payment system (Success or Canceled).

Example of the response in case of successful payment acceptance for processing:

application/json

{
  "order_no": "0001",
  "amount": "16",
  "currency_code": "UAH",
  "item_name": "Samsung TV",
  "co_inv_id": "1111111",
  "co_inv_st": "success"
}

Example of the response in case of payment cancellation:

application/json

{
  "order_no": "0001",
  "amount": "16",
  "currency_code": "UAH",
  "item_name": "Samsung TV",
  "co_inv_id": "1111111",
  "co_inv_st": "Canceled"
}

Final Status (Callback)¶

The callback mechanism is used to notify the merchant that the transaction has received a final status (for example, from “Pending” to “Success”).

It is described in detail in the Callbacks section.