Pago Móvil

Use this endpoint to submit a Pago Móvil payment in Venezuela. After the payment request is created, redirect the customer to the returned pay_url to complete the payment.

Payments are confirmed in real time after the customer completes the payment.

Refunds are not supported for this payment method.

Endpoint

POST https://gateway-test.pagsmile.com/trade/pay

Request headers

Header	Required	Description
Content-Type	Yes	Fixed value: application/json; charset=UTF-8.
Authorization	Yes	Basic authentication using Base64(app_id:security_key).

Request body

Parameter	Type	Required	Constraints	Description
app_id	string	Yes	Maximum length: 32 characters.	Merchant application ID assigned by Pagsmile.
out_trade_no	string	Yes	Maximum length: 64 characters. Must be unique for the merchant application.	Merchant order number.
method	string	Yes	Fixed value: PagoMovil.	Payment method.
order_currency	string	Yes	Fixed value: VES.	Payment currency.
region	string	Conditional	Fixed value: VEN. Required when using a Global app.	ISO 3166-1 alpha-3 code for Venezuela.
order_amount	decimal	Yes	May contain up to two decimal places. No method-specific minimum or maximum is currently specified.	Payment amount in VES.
subject	string	Yes	Maximum length: 128 characters.	Payment subject or order title.
content	string	No	Maximum length: 255 characters.	Payment description or order details.
timestamp	string	Yes	Format: yyyy-MM-dd HH:mm:ss. Maximum length: 19 characters.	Time at which the request is sent.
notify_url	string	Yes	Must be a valid URL. HTTPS is recommended.	Merchant endpoint that receives asynchronous payment notifications.
buyer_id	string	Yes	Maximum length: 128 characters.	Merchant-side customer ID.
bank	string	Yes	Provide a supported Venezuelan bank code, such as 0174.	Code of the customer's bank used for the Pago Móvil payment. See Bank in Venezuela for the complete list of supported bank codes.
customer.phone	string	Yes	Provide the customer's mobile phone number in the format supported by the selected bank.	Customer phone number used for the Pago Móvil payment.

Request example

{
  "app_id": "17****534",
  "out_trade_no": "out_trade_no_501***375",
  "order_currency": "VES",
  "method": "PagoMovil",
  "region": "VEN",
  "order_amount": "123",
  "subject": "pagsmile test",
  "content": "pagsmile test",
  "timestamp": "2024-07-04 18:50:42",
  "notify_url": "https://merchant.example.com/payment/notify",
  "buyer_id": "buyer123",
  "bank": "0174",
  "customer": {
    "phone": "584***567"
  }
}

Response example

{
  "code": "10000",
  "msg": "Success",
  "prepay_id": "Tm****-6F2c84",
  "trade_no": "2026***118",
  "out_trade_no": "out_trade_no_501****6375",
  "pay_url": "https://checkout-test.pagsmile.com/checkout?prepay_id=Tm****-6F2c84D2",
  "web_url": "",
  "trade_status": "PROCESSING",
  "beneficiary": {
    "bank_id": "0138",
    "bank_name": "BANCO PLAZA",
    "number": "0416****000",
    "name": "J0050****970"
  }
}

The beneficiary object contains the receiving account information generated for the payment. Always use the values returned for the current transaction; do not hardcode them.

Complete the payment

1. Redirect the customer to the complete pay_url returned by Pagsmile.

2. Allow the customer to complete the Pago Móvil payment using the information displayed on the checkout page.

3. Use the payment notification or the Payin Detail API to determine the final payment status.

A response with code=10000 confirms that the payment request was created. trade_status=PROCESSING does not mean that payment has been completed. Confirm the final successful status before delivering goods or services.