Credit Card

This endpoint allows you to submit a payin by CreditCard in Argentina.

To submit a CreditCard payin, you need to tokenize the card first, and then use the returned token to submit the payment.

Argentina CreditCard supports partial refund.

Step 1: Tokenize Card

Use the Card Tokenization API to tokenize the card information.

POST https://security-test.pagsmile.com/card/tokenize

Request Body

Parameter	Type	Required	Constraints	Description
app_id	string	Required	Max length: 32	The merchant application ID assigned by Pagsmile.
format	string	Required	Fixed value: JSON	Request format.
version	string	Required	Fixed value: 2.0	API version.
timestamp	string	Required	Format: yyyy-MM-dd HH:mm:ss; max length: 19	Request timestamp.
card.card_no	string	Required	Card number; use a valid test card number in the sandbox environment	Card number.
card.issuer	string	Required	Example: visa	Card issuer.
card.holder.name	string	Required	-	Cardholder name.
card.cvv	string	Required	3 or 4 digits	Card CVV.
card.valid_thru_year	string	Required	Format: yyyy	Card expiration year.
card.valid_thru_month	string	Required	Format: MM; value: 01–12	Card expiration month.

Request Sample

{
  "app_id": "162***33",
  "format": "JSON",
  "version": "2.0",
  "timestamp": "2026-07-06 11:08:10",
  "card": {
    "card_no": "4012***12",
    "issuer": "visa",
    "holder": {
      "name": "test uuu yyy"
    },
    "cvv": "123",
    "valid_thru_year": "2027",
    "valid_thru_month": "12"
  }
}

Response Sample

{
  "code": "10000",
  "msg": "Success",
  "token": "psct_ec031b***8eae"
}

Step 2: Submit Payin with Token

Use the returned token to submit a CreditCard payin.

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

Request Body

Parameter	Type	Required	Constraints	Description
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.
version	string	Required	Fixed value: 2.0	API version.
order_amount	string	Required	Supports up to 2 decimal places	Payment amount.
order_currency	string	Required	Fixed value: ARS	Payment currency.
method	string	Required	Fixed value: CreditCard	Payment method.
out_trade_no	string	Required	Max length: 64	Merchant order number. Must be unique.
subject	string	Required	Max length: 128	Payment subject or order title.
notify_url	string	Required	Valid URL	The URL to receive payment notifications.
buyer_id	string	Required	Max length: 64	Merchant-side user ID.
token	string	Required	Card token returned by the card tokenization API	The tokenized card information used to submit the card payment.
customer.identification.type	string	Required	Example: CUIT	Customer identification type.
customer.identification.number	string	Required	Required length: 11 digits for CPF, 14 digits for CNPJ	Customer identification number.

Request Sample

{
  "app_id": "1629***33",
  "timestamp": "2026-07-06 11:08:15",
  "version": "2.0",
  "order_amount": "61.6",
  "order_currency": "ARS",
  "method": "CreditCard",
  "out_trade_no": "out_193***00",
  "subject": "Test",
  "notify_url": "http://demo.testcase.cn/callback/success",
  "buyer_id": "buyer_1108",
  "token": "psct_ec031b***8eae",
  "customer": {
    "identification": {
      "type": "CUIT",
      "number": "502**7"
    }
  }
}

Response Sample

{
  "code": "10000",
  "msg": "Success",
  "sub_code": "200",
  "sub_msg": "",
  "out_trade_no": "53***4604",
  "prepay_id": "c2E***F9Ba6076",
  "trade_no": "2026***087",
  "trade_status": "PROCESSING",
  "web_url": ""
}