Documentation v1.0.0

Checkout (COLOMBIA)

Call the Checkout API to gives your buyers a simplified and secure checkout experience. SmartFastPay intelligently presents the most relevant payment types to your shoppers, automatically, making it easier for them to complete their purchase using PSE.

Make REST API calls

In REST API calls, include the URL to the API service for the environment:

  • Sandbox: https://sandbox-colombia.smartfastpay.com/
  • Live: https://api-colombia.smartfastpay.com/

Also, include your access token to prove your identity and access protected resources.

POST
/transaction/checkout
Request
 
                                                            
                                                                curl -v --location --request POST 'https://sandbox-colombia.smartfastpay.com/transaction/checkout' \
                                                                    --header 'Content-Type: application/json' \
                                                                    --header 'Authorization: Bearer < Access-Token >' \
                                                                    --data-raw '{
                                                                        "customer_id": "58f0c005-3b7d-4c75-81f3-93b9a6fee864",
                                                                        "name": "Richard Roe",
                                                                        "email": "richard@roe.com",
                                                                        "amount": 15000,
                                                                        "currency": "COP",
                                                                        "country": "COL",
                                                                        "callback": "http://mysite.com/api/notification",
                                                                        "transaction": {
                                                                            "id": "b08e3897-6505-4bb4-81a5-6e3a1d29e277",
                                                                            "redirect": {
                                                                                "url": "http://mysite.com/success_payment",
                                                                                "type": "URL"
                                                                            }
                                                                        }
                                                                    }'
                                                            
                                                        
Parameters details
 
Parameter Type Description
customer_id string
min: 1 | max: 255
required The customer id stored on your platform for future identification.
branch string
min: 1 | max: 255
optional When the merchant needs to keep track of its various offices / branch, this field must be fill.
name string
min: 3 | max: 150
required Name of the customer who started the transaction.
email string
min: 30 | max: 255
required Email of the customer who started the transaction.
amount decimal (10,2)
min: 2
required The amount that the client specified when initiating the transaction showed IN COLOMBIAN PESO (use dot instead of comma)
Eg: 300.10
currency string (3)
(COP)
min: 3 | max: 3
required The currency type that the amount will be credited.
COP is only allowed for the COL country
country string (3)
(COL)
min: 3 | max: 3
required The country type that the amount will be credited.
COP is only allowed for the COL country
callback string
min: 30 | max: 250
(Method: POST)
required The URL in you site that our API will notify when the payment changes the status, the HTTP supported method should be HTTP
Eg: http://my-url-callback/
transaction
id string
min: 1 | max: 255
required The id of the transaction generated in you platform.
redirect
url string
string
min: 30 | max: 250
required Redirect URL that we will set to our "back to website" button after the transaction was completed
type string
URL
min: 0 | max: 10
required Return type of the request, if HTML is provided the request will return the HTML of the page, if URL is provided the request will return a URL with that will redirect to the HTML page rendered.
Response (URL)
 
                                                            
                                                                {
                                                                    "requestId": "a2435636-5f69-447d-8e22-8382f62ef7dd",
                                                                    "data": {
                                                                        "url": "https://sandbox-checkout-colombia.smartfastpay.com/v1/cbfc1b2e-b1d7-42c0-8dc5-ffe94d64938e"
                                                                        "transaction_id": "cbfc1b2e-b1d7-42c0-8dc5-ffe94d64938e"
                                                                    }
                                                                }
                                                            
                                                        
Response (HTML)