Create payin link

Use link type general if you want Palomma to collect payment method details.

Authorizations

Authorization

string

headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

• General
• PSE
• Bancolombia Button
• Nequi Button
• Card
• Bancolombia Collect

customerId

string

required

The ID of the customer for whom the Payin Link is created.

redirectUrl

string

required

URL to which the customer will be redirected after the payment process.

amount

number

required

Amount to be paid in COP. Must be greater than $1500. The maxiumum is configured per merchant but defaults to $2.000.000. Contact us if you need to increase this limit.

type

enum<string>

required

Available options:

general

availableTypes

enum<string>[]

required

The payment methods types that are available for the customer to select.

Available options:

pse,

bancolombiaButton,

nequiButton,

card,

bancolombiaCollect

reference

string

An optional reference provided by the merchant to identify the Payin Link.

description

string

An optional description of the Payin Link.

expiration

string

Datetime when link will expire in YYYY-MM-DDTHH:mm:ss format. By default, expiration is at the end of the day after the link creation. Minimum expiration is the current date and maximum expiration is at the end of the 7th day from creation. Links expire shortly after the specified datetime has passed.

targetMerchantAccountId

string

An optional account ID of the target merchant account for this Payin Link.

Response

200 - application/json

id

string

Unique identifier for the Payin Link.

reference

string

An optional reference provided by the merchant to identify the Payin Link.

description

string

Description of the Payin Link.

customerId

string

The ID of the customer for whom the Payin Link is created.

customerDetails

object

Show child attributes

customerDetails.reference

string

An optional reference provided by the merchant to identify the customer.

customerDetails.name

string

First and last name for a natural person, and company name for a juridical person.

customerDetails.documentType

enum<string>

Colombian ID type for customer.

Available options:

cc,

ce,

nit

customerDetails.documentNumber

string

Colombian ID number for customer.

customerDetails.email

string

Customer’s email.

customerDetails.phoneNumber

string

Customer’s phone number.

status

enum<string>

The current status of the Payin Link.

Available options:

pending,

processing,

approved,

cancelled

statusMessage

enum<string>

Additional detail on the status. Only present when status is "cancelled".

Available options:

AUTHENTICATION_FAILED,

CUSTOMER_CANCELLATION,

DECLINED_BY_BANK,

EXPIRED,

INVALID_ACCOUNT,

NOT_ENOUGH_FUNDS,

ERROR

paymentUrl

string

URL to which the customer can go to complete the payment.

redirectUrl

string

URL to which the customer will be redirected after the payment process.

amount

number

The total amount to be paid in COP.

amountCollected

number

The amount that has been collected in COP.

fee

number

Any fee associated with the Payin Link.

type

enum<string>

The type of Payin Link

Available options:

general,

pse,

bancolombiaButton,

nequiButton,

card,

bancolombiaCollect

expiration

string

Datetime when link will expire in YYYY-MM-DDTHH:mm:ss format. By default, expiration is at the end of the day after the link creation. Minimum expiration is the current date and maximum expiration is at the end of the 7th day from creation. Links expire shortly after the specified datetime has passed.

targetMerchantAccountId

string

Account ID of the target merchant account for this Payin Link.

createdAt

string

ISO string representing when the Payin Link was created.

updatedAt

string

ISO string representing when the Payin Link was last updated.