Authorization

How to create an authorization.

Authorization

POST https://gateway-test.pagsmile.com/trade/pre-authorization

This endpoint allows you to create an authorization.

Headers

Name	Type	Description
Content-Type*	string	application/json; chartset=UTF-8
Authorization*	string	Basic Base($app_id:$security_key)

Name

Type

Description

Content-Type*

string

application/json; chartset=UTF-8

Authorization*

string

Basic Base($app_id:$security_key)

Request Body

Name	Type	Description
app_id*	string	created app's id at dashboard - Max. 32 chars -
timestamp*	string	yyyy-MM-dd HH:mm:ss - Max. 19 chars -
buyer_id*	string	buyer id
content	string
format*	string	Fixed value: JSON
notify_url*	string	Where Pagsmile will send notification to
order_amount*	number	payment amount
order_currency*	string
out_trade_no*	string	ID given by the merchant in their system - Max. 64 chars -
return_url	string	Redirect to Merchant's url when user finished checkout
subject*	string
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)
version	string	Fixed value: 2.0
token*	string	The token received from Tokenization API.
website_url	string
threeds.sli	string	Security level indicator
threeds.status*	string	3DSecure - Status text received from 3D secure vendor
threeds.liability_shift*	string	liability shift - indicate whether the chargeback liability shifted to the card issuer
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.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.cavv*	string	Authentication Value (CAVV / AAV for 3DS1) recieved from authorization/Authentication response
threeds.version*	string	The version of the 3D Secure that was used for authentication
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.
method*	string	Fixed value: CreditCard
trade_type*	string	Fixed value: API
issuer*	string	issuer of the card.

Name

Type

Description

app_id*

string

created app's id at dashboard

- Max. 32 chars -

timestamp*

string

yyyy-MM-dd HH:mm:ss - Max. 19 chars -

buyer_id*

string

buyer id

content

string

format*

string

Fixed value: JSON

notify_url*

string

Where Pagsmile will send notification to

order_amount*

number

payment amount

order_currency*

string

out_trade_no*

string

ID given by the merchant in their system - Max. 64 chars -

return_url

string

Redirect to Merchant's url when user finished checkout

subject*

string

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)

version

string

Fixed value: 2.0

token*

string

The token received from Tokenization API.

website_url

string

threeds.sli

string

Security level indicator

threeds.status*

string

3DSecure - Status text received from 3D secure vendor

threeds.liability_shift*

string

liability shift - indicate whether the chargeback liability shifted to the card issuer

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.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.cavv*

string

Authentication Value (CAVV / AAV for 3DS1) recieved from authorization/Authentication response

threeds.version*

string

The version of the 3D Secure that was used for authentication

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.

method*

string

Fixed value: CreditCard

trade_type*

string

Fixed value: API

issuer*

string

issuer of the card.

{
    "msg": "Success",
    "code": "10000",
    "out_trade_no": "8335***600",
    "web_url": "",
    "trade_no": "2022***215",
    "prepay_id": "MnFrV****OD0=-a220184D"

}

{
    "code":"40002",
    "msg":"Business Failed",
    "sub_code":"invalid-signature",
    "sub_msg":"invalid signature"
}

Example

curl --location --request POST 'https://gateway-test.pagsmile.com/trade/pre-authorization' \
--header 'Authorization: Basic MTYyNTgyOTIxNDUzMTY2Mzg6UGFnc21pbGVfc2tfZDUwMWQ1ZGNkNTI5OGQ5N2MwNmUzYjI4YjA2OWZjZmY3NDU5ZjY2NzNiMjFjMTFlYTY3NDM5MDgzOTZkOTYxNQ==' \
--header 'Content-Type: application/json' \
--data-raw '{
    * "app_id": "1617****8052",
    * "timestamp": "2022-08-11 10:25:46",
    * "format": "JSON",
    * "out_trade_no": "out_181***1300",
    * "method": "CreditCard",
    * "order_amount": "120",
    * "order_currency": "BRL",
    * "subject": "Cobrança única digital",
    * "content": "trade pay test conent",
    * "trade_type": "API",
    * "notify_url": "http://demo.gemini-tiger.cn/callback/success",
      "return_url": "http://demo.gemini-tiger.cn/test",
    * "buyer_id": "buyer_0810",
      "timeout_express":"30m",
    * "token":"psct_b67******ecad89a5de",
      "version": "2.0",
      "website_url": "www.xcloud.com",
    * "issuer": "VISA",
    * "threeds": {
    *       "version":"2",
    *       "cavv":"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA",
    *       "eci":"05",
    *       "acs_trans_id":"7777-8797-4645-1233",
    *       "ds_trans_id":"7777-8797-4645-1233",
    *       "status":"Cardholder authenticated",
    *       "status_code":"Y",
    *       "status_reason_code":"15",
    *       "liability_shift":"true"
      },
}'

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.

PreviousCreate Card Payment NextCapture

Last updated 2 months ago