PSE - H2H
Call the Payments API to request payments via PSE on Colombia
Here you'll find the specific parameters required for integrating this payment method in the selected country. These parameters are tailored to meet the unique requirements of this region and payment type. For a complete list of global parameters and detailed explanations, please refer to the Overview page, where you'll find all the foundational elements that apply across different countries and methods.
POST /v2/payin
curl -v --location --request POST 'https://sandbox.smartfastpay.com/v2/payin' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <Access-Token>' \
--data-raw '{
"customer": {
"id": "58f0c005-3b7d-4c75-81f3-93b9a6fee864",
"name": "Richard Roe",
"email": "[email protected]",
"phone": "+573041093694",
"document": {
"number": "12345678",
"type": "CC"
},
"address": {
"address_1": "Dare Groves",
"address_2": null,
"number": "130",
"neighborhood": "Courtney Jacobi",
"city": "East Savionbury",
"state": "CUN",
"postal_code": "757126",
"country_code": "COL"
}
},
"transaction": {
"id": "b08e3897-6505-4bb4-81a5-6e3a1d29e277",
"currency": "COP",
"amount": 2000,
},
"country": "COL",
"payment_method": "pse",
"notification_url": "https://mysite.com/api/notification",
"extra": {
"bank_code": "1007"
}
}'customer.id
string
yes
Unique identifier for the customer in your system. This value should remain consistent across all transactions for the same customer
customer.name
string
yes
The full name of the customer making the payment. It should match the name on the customer's identification documents
customer.email
string
no
The email address of the customer. This will be used for sending payment confirmations and notifications
customer.phone
string
E.164
yes
The phone number of the customer, including the country code. This parameter may be optional or required depending on the payment method used
customer.document.number
string
yes
The official identification number of the customer. This is typically a national ID, or other government-issued document
customer.document.type
string
yes
The type of document provided by the customer. Common types include national ID, or driver's license. List of documents allowed.
transaction.id
string
yes
A unique identifier for the transaction. This ID should be generated by your system to track the specific payment process
transaction.currency
string
yes
The currency in which the transaction is being conducted. Use standard ISO 4217 currency codes (e.g., USD, PEN). List of currency codes.
transaction.amount
decimal
(10,2)
yes
The total amount of the transaction in the specified currency. This value should be a numeric amount (use dot instead of comma)
Eg: 300.10
transaction.expire
integer (11)
no
The time in seconds until the transaction expires and is no longer valid
branch
string
no
The specific branch or location identifier where the transaction is being processed, if applicable
country
string
yes
The country code where the transaction is taking place. The format is ISO 3166-1 alpha-3 (e.g., COL). List of country codes.
payment_method
string
yes
The method of payment being used for the transaction, such as bank transfer, credit card...
notification_url
string
yes
The URL to which payment notifications will be sent. Ensure this URL is accessible and configured to handle the notification format
extra.bank_code
string
yes
Some providers require you to provide the bank code. If you need details about the banks, see the bank code list section in the documentation. List of bank codes.
customer.address.addres_1
string
yes
The primary street address of the customer
customer.address.addres_2
string
yes
Additional address information, such as apartment number or suite
customer.address.city
string
yes
The city in which the customer resides
customer.address.country_code
string
yes
The ISO 3166-1 alpha-3 country code for the customer's address. List of country codes.
customer.address.neightborhood
string
yes
The neighborhood or district of the customer's address
customer.address.number
string
yes
The street number of the address
customer.address.postal_code
string
yes
The postal or ZIP code for the customer's address
customer.address.state
string
yes
The state or region of the customer's address
{
"requestId": "b299549a8e75ead38c176932c3f59da0/13462186452875824120",
"data": {
"id": "4a79f3b4-8d55-428b-a560-984fedd6f78a",
"status": "pending",
"expires_in": 1722108649,
"payment": {
"method": "pse",
"url": "https://secure.pse.lat/t/smartfastpay"
},
"values": {
"source_total": "10000.00000000",
"source_currency": "COP",
"exchanged_total": "10000.00000000",
"exchanged_currency": "COP",
"exchange": 1.00,
"fee": "200.00000000"
}
}
}Last updated