Bank transfer payment

Once you have obtained all the required fields, you can proceed to make a payment order.

POST https://[base_url]/v2/apms/bank-transfer

Body

Request using the POST method, this endpoint generates a payment uYesng the PSE payment method.

{
    "order": {
        "ref_name": "John",
        "ref_lastname": "Doe",
        "ref_number": "123456789",
        "detail": "Booking payment Hotel ABC",
        "amount": 5000,
        "tax_percent": 0,
        "service_percent": 0,
        "hotel_id": 103,
        "email": "[email protected]",
        "fiscal_number": "1078455221",
        "phone": "3012104578",
        "ip": "181.204.153.195"
    },
    "bank_transfer": {
        "bank_code": "1022",
        "response_url": "https://mywebpage/payment/response",
        "user_type": "N",
        "fiscal_number_type": "CE",
        "address": "St. 45 - 34"
    }
}

Body parameters

PARAMETER	TYPE	REQ.	DESCRIPTION
order.ref_name	String	Yes	Guest's name
order.ref_lastname	String	Yes	Guest's lastname
order.ref_number	String	Yes	Reservation number
order.detail	String	Yes	Additional notes
order.amount	Float	Yes	Amount to be charged in COP
order.tax_percent	Float	No	Tax rate to apply to this payment. Format: Decimal with two fraction digits, the value must be between 0.00 and 1.00.
order.service_percent	Float	No	Service charge rate to apply to this payment. Format: Decimal with two fraction digits, the value must be between 0.00 and 1.00.
order.hotel_id	Integer	Yes	Hotel ID associated with the reservation. Refer to List hotels
order.email	String	Yes	Buyer's email address
order.fiscal_number	String	Yes	Buyer's document number
order.phone	String	Yes	Buyer's phone number
order.ip	String	Yes	Buyer's IPv4
pse.bank_code	String	Yes	"code" from the selected bank in Bank list
pse.response_url	String	Yes	Customer destination, once the payment is completed. We recommend that a query be made at this URL to show the customer the final status of the transaction.
pse.user_type	String	Yes	Person type. We expect a "code" that can be obtained in User types
pse.fiscal_number_type	String	Yes	Document type. We expect a "code" that can be obtained in Identification types
pse.address	String	Yes	Buyer's address

Endpoint response

{
    "transaction_id": "451952918",
    "apm_detail_id": 22,
    "checkout_url": "https://registro.desarrollo.pse.com.co/PSENF/index.html?enc=R7bPKooRTQrdrPsFpvAc2lka3BcB1XqKUz%2bTuWpJu6k%3d"
}