Get All Payment Requests

Returns a list of all Payment Request objects corresponding to the merchant.

Authorizations

Authorization

string

header

required

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

Response

200 - application/json

items

object[]

Show child attributes

items.amount

number

Amount to collect from the customer's payment method, with no more than two decimal places.

items.approvedDetails

object

Show child attributes

items.approvedDetails.approvedAt

string

ISO string when the payment request was approved.

items.approvedDetails.paidAt

string

ISO string when the payment request was paid out to the merchant, or null for unpaid transactions.

items.approvedDetails.status

enum<string>

Indicates the payment request is approved.

Available options:

approved

items.createdAt

string

ISO string when the payment request was created.

items.currency

string

Always "cop" (Colombian Pesos).

items.customerDetails

object

Show child attributes

items.customerDetails.documentNumber

string

Colombian ID number for customer.

items.customerDetails.documentType

enum<string>

Colombian ID type for customer.

Available options:

cc,

ce,

nit

items.customerDetails.email

string

Customer’s email.

items.customerDetails.name

string

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

items.customerId

string

Reference to the customer who owns the payment method from which the payment request was created.

items.errorDetails

object

Show child attributes

items.errorDetails.errorAt

string

ISO string when the payment request resolved to an error.

items.errorDetails.errorCode

string

Error code returned by financial institution that processed the transaction.

items.errorDetails.errorMessage

string

Description of the error in the transaction from the processing financial institution.

items.errorDetails.status

enum<string>

Indicates the payment request resulted in an error.

Available options:

error

items.id

string

Unique identifier for this payment request.

items.paymentMethodDetails

object

Show child attributes

items.paymentMethodDetails.bancolombiaInstant

object | null

Information about the Bancolombia account associated to this payment method. Only present when payment method type is "bancolombiaInstant".

Show child attributes

items.paymentMethodDetails.bancolombiaInstant.affiliate

object

Show child attributes

items.paymentMethodDetails.bancolombiaInstant.affiliate.accountNumber

string

Last four digits of account number for linked Bancolombia account.

items.paymentMethodDetails.bancolombiaInstant.affiliate.accountType

string

Account type for linked Bancolombia account.

items.paymentMethodDetails.bancolombiaInstant.affiliate.documentNumber

string

Document number for linked Bancolombia account owner.

items.paymentMethodDetails.bancolombiaInstant.affiliate.documentType

string

Document type for linked Bancolombia account owner.

items.paymentMethodDetails.bancolombiaInstant.affiliate.name

string

Name of the linked Bancolombia account owner.

items.paymentMethodDetails.bankAccount

object

Show child attributes

items.paymentMethodDetails.bankAccount.accountNumber

string

Account number for payment method.

items.paymentMethodDetails.bankAccount.accountType

enum<string>

Account type for payment method.

Available options:

savings,

checking

items.paymentMethodDetails.bankAccount.bank

enum<string>

Enum of all available banks for direct debit through the Palomma API.

Available options:

santander,

coofinep,

avvillas,

cotrafa,

confiar,

union,

nequi,

bancoagrario,

bancoomeva,

bancamia,

coopcentral,

citibank,

bancodeoccidente,

falabella,

bancodebogota,

bancocajasocial,

serfinanza,

cfa,

coltefinanciera,

pichincha,

iris,

ban100,

bancopopular,

daviplata,

bancolombia,

finandina,

scotiabankcolpatria,

gnbsudameris,

itau,

bbva,

davivienda,

mibanco,

multibank,

mundomujer,

procreditcolombia,

bancow,

bancoldex,

juriscoop,

itauhelm,

jpmorgancolombia

items.paymentMethodDetails.nequiInstant

object | null

Information about the Nequi account associated to this payment method. Only present when payment method type is "nequiInstant".

Show child attributes

items.paymentMethodDetails.nequiInstant.phoneNumber

string

items.paymentMethodDetails.type

enum<string>

Type of payment method created. Can be "bankAccount" for an account that transacts through traditional slower banking rails, or "bancolombiaInstant", "nequiInstant" for tokenized instant payment accounts.

Available options:

bankAccount,

bancolombiaInstant,

nequiInstant

items.paymentMethodId

string

Reference to the payment method from which the payment request was created.

items.status

enum<string>

Current status of the payment request.

Available options:

pending,

processing,

approved,

error

items.updatedAt

string

ISO string when the payment request was last updated.