Virtual Account
This section describes how to create a Virtual Account, query the Virtual Account status, and receive payment notifications for Argentina Virtual Account payments.
Argentina Virtual Account payments use BankTransfer as the payment method.
For Argentina Virtual Account payments, the Virtual Account is created first. After the payer transfers funds to the assigned account number, Pagsmile sends an asynchronous notification to the merchant's notify_url.
Create Virtual Account
Use this endpoint to create a Virtual Account for Argentina.
POST https://gateway-test.pagsmile.com/virtual-account/create
Request Body
app_id
string
Required
Max length: 32
The merchant application ID assigned by Pagsmile.
timestamp
string
Required
Format: yyyy-MM-dd HH:mm:ss; max length: 19
Request timestamp.
notify_url
string
Required
Valid URL
The URL to receive Virtual Account payment notifications.
method
string
Required
Fixed value: BankTransfer
Payment method.
region
string
Required
Fixed value: ARG
Country or region code.
customer.buyer_id
string
Required
Max length: 64
Merchant-side user ID.
customer.username
string
Optional
Max length: 128
Customer Name
customer.identify.type
string
Optional
Example: CUIT
Customer identification type.
customer.identify.number
string
Optional
-
Customer identification number.
Request Sample
Response Sample
After the Virtual Account is created successfully, use the returned account_number to instruct the payer to complete the bank transfer.
Query Virtual Account
Use this endpoint to query the Virtual Account information and status.
POST https://gateway-test.pagsmile.com/virtual-account/query
Request Body
app_id
string
Required
Max length: 32
The merchant application ID assigned by Pagsmile.
timestamp
string
Required
Format: yyyy-MM-dd HH:mm:ss; max length: 19
Request timestamp.
account_id
string
Required
Max length: 64
The Virtual Account ID returned by the Create Virtual Account API.
Request Sample
Response Sample
Notification
After the payer completes the bank transfer, Pagsmile sends an asynchronous notification to the merchant's notify_url.
Notification Body
amount
string
Payment amount received.
out_trade_no
string
Pagsmile-generated transaction reference.
method
string
Payment method. Fixed value: BankTransfer.
trade_status
string
Transaction status. Example: SUCCESS.
trade_no
string
Pagsmile transaction number.
currency
string
Payment currency. Fixed value: ARS.
app_id
string
The merchant application ID assigned by Pagsmile.
user.buyer_id
string
Merchant-side user ID used when creating the Virtual Account.
user.email
string
User's email address used when creating the Virtual Account.
user.identification.number
string
User identification number used when creating the Virtual Account.
user.identification.type
string
User identification type used when creating the Virtual Account. Example: CUIT.
timestamp
string
Notification timestamp.
transfer_account.account_id
string
Virtual Account ID.
transfer_account.account_number
string
Virtual Account number.
Notification Sample
Use the asynchronous notification as the final transaction result. The payer may complete the bank transfer after the Virtual Account is created.
Last updated