Create Card Payment
How to create a card payment.
Last updated
How to create a card payment.
Last updated
POST https://gateway-test.pagsmile.com/trade/pay
This endpoint allows you to create a card payment.
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
The merchant should have 3DS provider to get the value of "threeds".
Note: 162************38 is pagsmile's test app id for sandbox, and MTYyNTgyOTIxNDUzMTY2Mzg6UGFnc21pbGVfc2tfZDUwMWQ1ZGNkNTI5OGQ5N2MwNmUzYjI4YjA2OWZjZmY3NDU5ZjY2NzNiMjFjMTFlYTY3NDM5MDgzOTZkOTYxNQ== is authorization token associated with the test app id.
Please use your own app_id and generate your own authorization token when testing.
Content-Type*
string
application/json; chartset=UTF-8
Authorization*
string
Basic Base($app_id:$security_key)
app_id*
string
created app's id at dashboard
- Max. 32 chars -
customer.phone
string
User's phone
customer.email
string
User's email
customer.identify.number
string
User's identification number
- 11 digits if CPF or 14 digits if CNPJ -
method*
string
Fixed value: CreditCard
out_trade_no*
string
ID given by the merchant in their system - Max. 64 chars -
notify_url*
string
Where Pagsmile will send notification to
customer.identify.type
string
User's identification type
- CPF or CNPJ -
customer.name
string
User's name
timestamp*
string
yyyy-MM-dd HH:mm:ss - Max. 19 chars -
subject*
string
payment reason or item title
- Max. 128 chars -
order_amount*
string
payment amount - 0.5~50000 BRL -
order_currency*
string
Fixed value: BRL
content*
string
payment reason detail or item detail. This will be shown on the bank bill.
- Max. 255 chars -
buyer_id*
string
merchant user's id
address.zip_code
string
zip code
website_url
string
merchant website URL
- Max. 128 chars -
address.street
string
street
- Required if zip_code not provide -
address.street_number
string
street number
- Required if zip_code not provide -
address.city
string
city
- Required if zip_code not provide -
address.state
string
state - Required if zip_code not provide -
return_url
string
Redirect to Merchant's url when user finished checkout
token*
string
use Pagsmile Javascript to get toekn
issuer*
string
issuer of CreditCard
installments
string
installments for CreditCard
user_ip*
string
user's IP address
threeds.server_trans_id
string
Universally unique transaction identifier assigned by the 3DS Server to identify a single transaction generated by the Init 3DS API and used to link the init call to the order call
threeds.version
string
Version used in the transaction
threeds.cavv
string
Authentication Value (CAVV / AAV for 3DS1) recieved from authorization/Authentication response
threeds.status_code
string
3DSecure - Status code recieved from authorization/authentication response, (Possible values: U, N, Y, A, C, D, R, I)
threeds.eci
string
ECI value recieved from authorization/authentication response
threeds.status
string
3DSecure - Status text received from 3D secure vendor
threeds.status_reason_code
string
String EMVCO Indicator of the reason for the 3DS status code provided during the authentication, (Possible values: 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12, 13, 14, 15, 16)
threeds.liability_shift
string
liability shift - indicate whether the chargeback liability shifted to the card issuer
threeds.acs_trans_id
string
This field contains a universally unique transaction identifier assigned by the ACS to identify a single transaction.
threeds.ds_trans_id
string
A universally unique transaction identifier is assigned by the DS to identify a single transaction.
timeout_express
string
m(minutes), h(hours), d(days), c(always end in current day).
Used to control the expiration time of submitting an order (from initial to processing). (90m in default, max 15d)