Skip to main content
POST
/
v1
/
stores
/
{store}
/
payments
Create payment
curl --request POST \
  --url https://api.confiopagos.com/v1/stores/{store}/payments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amountCents": 5000000,
  "currencyCode": "COP",
  "title": "Juguete",
  "description": "Juguete increíble",
  "buyer": {
    "firstName": "Julián",
    "phoneNumber": "+573215786325",
    "lastName": "Pérez",
    "email": "santiago@example.com"
  },
  "correlationId": "36285414",
  "mediaAssets": [
    "https://fastly.picsum.photos/id/1074/1024/1024.jpg?hmac=usAeJI_o3wzbLAca-PMBgHQXXhSoMNP5cvoktlhiUzY",
    "https://fastly.picsum.photos/id/506/1024/1024.jpg?hmac=Wa93nuNDFEXWB_Fg4n2vcYT3sGcW7UBTjOAic46R9Gw",
    "https://fastly.picsum.photos/id/343/1024/1024.jpg?hmac=WC3PsYGjbqnsQhfu1J1l3PeAzmsGEiZPISXAenRc2Qc"
  ],
  "enabledPaymentMethods": [
    "PSE",
    "CARD",
    "NEQUI",
    "BANCOLOMBIA"
  ],
  "paymentType": "PRODUCT",
  "redirectUri": "https://example.com/payment-status",
  "courier": "Coordinadora",
  "trackingNumber": "453265",
  "disableBuyerNotification": false,
  "discountPercentage": 0.1,
  "discountSource": "ty_page_cod_conversion"
}
'
{
  "amountCents": 5000000,
  "currencyCode": "COP",
  "title": "Juguete",
  "description": "Juguete increíble",
  "buyer": {
    "firstName": "Julián",
    "phoneNumber": "+573215786325",
    "lastName": "Pérez",
    "email": "santiago@example.com"
  },
  "name": "stores/01JNRRDZDPH40DB2YRW329BFXM/payments/01JNRVWWHH68E76V3TMFFT6GHJ",
  "status": "AWAITING_PAYMENT",
  "organization": "organizations/01JNRR1NY8MDX4XCGG0N4F06X3",
  "url": "https://checkout.confiopagos.com/p/01JNV8CSHNN933B09T5MTNK89V",
  "correlationId": "36285414",
  "mediaAssets": [
    "https://fastly.picsum.photos/id/1074/1024/1024.jpg?hmac=usAeJI_o3wzbLAca-PMBgHQXXhSoMNP5cvoktlhiUzY",
    "https://fastly.picsum.photos/id/506/1024/1024.jpg?hmac=Wa93nuNDFEXWB_Fg4n2vcYT3sGcW7UBTjOAic46R9Gw",
    "https://fastly.picsum.photos/id/343/1024/1024.jpg?hmac=WC3PsYGjbqnsQhfu1J1l3PeAzmsGEiZPISXAenRc2Qc"
  ],
  "enabledPaymentMethods": [
    "PSE",
    "CARD",
    "NEQUI",
    "BANCOLOMBIA"
  ],
  "paymentType": "PRODUCT",
  "redirectUri": "https://example.com/payment-status",
  "courier": "Coordinadora",
  "trackingNumber": "453265",
  "disableBuyerNotification": false,
  "discountPercentage": 0.1,
  "discountSource": "ty_page_cod_conversion"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
store
string
required
Example:

"01G65Z755AFWAKHE12NY0CQ9FH"

Body

application/json
​
amountCents
number
required

Amount in cents

Required range: x >= 1000000
Example:

5000000

​
currencyCode
string
required

Currency code

Example:

"COP"

​
title
string
required

Payment title

Example:

"Juguete"

​
description
string
required

Payment description (at least 24 characters)

Example:

"Juguete increíble"

​
buyer
object
required
​
correlationId
string

Your internal payment/order ID for tracking and correlation. Use this to match Confío payments with your system's orders.

Example:

"36285414"

​
mediaAssets
string<uri>[]

Media assets links (required when paymentType is PRODUCT, max 6 items). Each URL must be a publicly accessible URL from a public server (e.g., your CDN, cloud storage, or any public web server). Allowed formats: PNG, JPEG, JPEG XL, WebP, AVIF, GIF, ICO, SVG, HEIC, BMP, TIFF. Maximum file size: 100MB per file.

Maximum array length: 6
Example:
[
  "https://fastly.picsum.photos/id/1074/1024/1024.jpg?hmac=usAeJI_o3wzbLAca-PMBgHQXXhSoMNP5cvoktlhiUzY",
  "https://fastly.picsum.photos/id/506/1024/1024.jpg?hmac=Wa93nuNDFEXWB_Fg4n2vcYT3sGcW7UBTjOAic46R9Gw",
  "https://fastly.picsum.photos/id/343/1024/1024.jpg?hmac=WC3PsYGjbqnsQhfu1J1l3PeAzmsGEiZPISXAenRc2Qc"
]
​
enabledPaymentMethods
enum<string>[]

Optional list of payment methods to enable for this payment. If omitted, all available methods are shown.

Available options:
PSE,
CARD,
BANCOLOMBIA,
NEQUI
Example:
["PSE", "CARD", "NEQUI", "BANCOLOMBIA"]
​
paymentType
enum<string>
default:PRODUCT

Payment type: 'PRODUCT' or 'SERVICE', default is 'PRODUCT'

Available options:
PRODUCT,
SERVICE
Example:

"PRODUCT"

​
redirectUri
string<uri>

Redirect URI after payment creation

Example:

"https://example.com/payment-status"

​
courier
string

Name of the courier service used for delivery (optional)

Example:

"Coordinadora"

​
trackingNumber
string

Courier tracking number for delivery (optional)

Example:

"453265"

​
disableBuyerNotification
boolean
default:false

Disable WhatsApp notification to buyer on payment creation. By default, a notification is sent to the buyer's WhatsApp when a payment is created. Set to true to disable this notification.

Example:

false

​
discountPercentage
number

Discount percentage applied to the payment as decimal (0-1, e.g., 0.35 for 35%).

Required range: 0 <= x <= 1
Example:

0.1

​
discountSource
string

The source of the discount (e.g., 'ty_page_cod_conversion', 'promo_code', 'referral')

Example:

"ty_page_cod_conversion"

Response

Successfully processed creation.

​
amountCents
number
required

Amount in cents

Required range: x >= 1000000
Example:

5000000

​
currencyCode
string
required

Currency code

Example:

"COP"

​
title
string
required

Payment title

Example:

"Juguete"

​
description
string
required

Payment description (at least 24 characters)

Example:

"Juguete increíble"

​
buyer
object
required
​
name
string
required

Payment's resource name

Example:

"stores/01JNRRDZDPH40DB2YRW329BFXM/payments/01JNRVWWHH68E76V3TMFFT6GHJ"

​
status
enum<string>
required

Payment status

Available options:
STATUS_UNSPECIFIED,
AWAITING_PAYMENT,
PAYMENT_IN_PROGRESS,
FUNDED,
DELIVERING,
UNDER_REVIEW,
APPROVED,
DISPUTED,
REFUNDED,
EXPIRED,
CANCELED,
FAILED
Example:

"AWAITING_PAYMENT"

​
organization
string
required

Organization's resource name

Example:

"organizations/01JNRR1NY8MDX4XCGG0N4F06X3"

​
url
string
required

Payment link

Example:

"https://checkout.confiopagos.com/p/01JNV8CSHNN933B09T5MTNK89V"

​
correlationId
string

Your internal payment/order ID for tracking and correlation. Use this to match Confío payments with your system's orders.

Example:

"36285414"

​
mediaAssets
string<uri>[]

Media assets links (required when paymentType is PRODUCT, max 6 items). Each URL must be a publicly accessible URL from a public server (e.g., your CDN, cloud storage, or any public web server). Allowed formats: PNG, JPEG, JPEG XL, WebP, AVIF, GIF, ICO, SVG, HEIC, BMP, TIFF. Maximum file size: 100MB per file.

Maximum array length: 6
Example:
[
  "https://fastly.picsum.photos/id/1074/1024/1024.jpg?hmac=usAeJI_o3wzbLAca-PMBgHQXXhSoMNP5cvoktlhiUzY",
  "https://fastly.picsum.photos/id/506/1024/1024.jpg?hmac=Wa93nuNDFEXWB_Fg4n2vcYT3sGcW7UBTjOAic46R9Gw",
  "https://fastly.picsum.photos/id/343/1024/1024.jpg?hmac=WC3PsYGjbqnsQhfu1J1l3PeAzmsGEiZPISXAenRc2Qc"
]
​
enabledPaymentMethods
enum<string>[]

Optional list of payment methods to enable for this payment. If omitted, all available methods are shown.

Available options:
PSE,
CARD,
BANCOLOMBIA,
NEQUI
Example:
["PSE", "CARD", "NEQUI", "BANCOLOMBIA"]
​
paymentType
enum<string>
default:PRODUCT

Payment type: 'PRODUCT' or 'SERVICE', default is 'PRODUCT'

Available options:
PRODUCT,
SERVICE
Example:

"PRODUCT"

​
redirectUri
string<uri>

Redirect URI after payment creation

Example:

"https://example.com/payment-status"

​
courier
string

Name of the courier service used for delivery (optional)

Example:

"Coordinadora"

​
trackingNumber
string

Courier tracking number for delivery (optional)

Example:

"453265"

​
disableBuyerNotification
boolean
default:false

Disable WhatsApp notification to buyer on payment creation. By default, a notification is sent to the buyer's WhatsApp when a payment is created. Set to true to disable this notification.

Example:

false

​
discountPercentage
number

Discount percentage applied to the payment as decimal (0-1, e.g., 0.35 for 35%).

Required range: 0 <= x <= 1
Example:

0.1

​
discountSource
string

The source of the discount (e.g., 'ty_page_cod_conversion', 'promo_code', 'referral')

Example:

"ty_page_cod_conversion"