Skip to main content

Paycash

  https://api-sandbox.epag.io/payment/MY_PAYMENT_TOKEN/sendPayment

Paycash is an Alternative Payment Method (APM) tailored predominantly for cash transactions, mirroring the operational framework of other APMs within the Latin American region.

The way Paycash works is quite straightforward:

  • Payment Transfer:

    • A business generates a Paycash reference and shares it with the customer.
    • The customer enters their mobile banking details, along with the agreement number and the reference.
    • Once the payment is made, the business is notified immediately.
  • Cash Payment:

    • Similarly, a business generates a Paycash reference for the customer.
    • The customer then visits any of the numerous payment points to make the payment.
    • The payment is processed, and the business is notified right away.

This method processes a PAYCASH payment order that were already created using the Create Payment Order method.

Request Fields

  • method (required/string): Payment method. Valid option: PAYCASH.
  • expiration_date (optional/date/YYYY-MM-DD): Expiration date (if not informed system will assume 5 days of current date).

Response Fields

  • payment_token (string): Token to identify this payment.
  • refresh_token (string): Updated access token for next calls.
  • transaction_status (string): Status of this payment.
  • paycash_amount (string): Amount of this payment.
  • paycash_barcode (string): Text string containing the barcode.
  • paycash_barcode_image (string): Base64 Zipped PNG representation of Paycash barcode.
  • paycash_instructions_link (string): Link to access the payment instructions.
AUTHORIZATIONAPI Key
KeyX-Auth-Token
ValueMY_ACCESS_TOKEN

Body Raw(json)

json
{
"method": "PAYCASH",
"expiration_date": "2024-05-09"
}

Exemple Request

Mexico

Example Request

200 - Success
    curl --location 'https://api-sandbox.epag.io/payment/MY_PAYMENT_TOKEN/sendPayment' \
--header 'X-Auth-Token: MY_ACCESS_TOKEN' \
--data '{
"method": "PAYCASH",
"expiration_date": "2024-05-09"
}'

Example Response

Header
  Content-Type: application/json
Body
    {
"transaction_status": "PROCESSING",
"payment_token": "42afe884-f047-4452-a3db-65a7de76a9c5",
"paycash_barcode": "2521709744061841",
"paycash_amount": "123.45",
"paycash_barcode_image": "BASE64_ZIPPED_PNG",
"paycash_instructions_link": "",
"refresh_token": "MY_ACCESS_TOKEN"
}
Colombia

Example Request

200 - Success
    curl --location 'https://api-sandbox.epag.io/payment/MY_PAYMENT_TOKEN/sendPayment' \
--header 'X-Auth-Token: MY_ACCESS_TOKEN' \
--data '{
"method": "PAYCASH",
"expiration_date": "2024-05-09"
}'

Example Response

Header
  Content-Type: application/json
Body
    {
"transaction_status": "PROCESSING",
"payment_token": "42afe884-f047-4452-a3db-65a7de76a9c5",
"paycash_barcode": "2521709744061841",
"paycash_amount": "123.45",
"paycash_barcode_image": "BASE64_ZIPPED_PNG",
"paycash_instructions_link": "",
"refresh_token": "MY_ACCESS_TOKEN"
}
Costa Rica

Example Request

200 - Success
    curl --location 'https://api-sandbox.epag.io/payment/MY_PAYMENT_TOKEN/sendPayment' \
--header 'X-Auth-Token: MY_ACCESS_TOKEN' \
--data '{
"method": "PAYCASH",
"expiration_date": "2024-05-09"
}'

Example Response

Header
  Content-Type: application/json
Body
    {
"transaction_status": "PROCESSING",
"payment_token": "42afe884-f047-4452-a3db-65a7de76a9c5",
"paycash_barcode": "2521709744061841",
"paycash_amount": "123.45",
"paycash_barcode_image": "BASE64_ZIPPED_PNG",
"paycash_instructions_link": "",
"refresh_token": "MY_ACCESS_TOKEN"
}
Ecuador

Example Request

200 - Success
    curl --location 'https://api-sandbox.epag.io/payment/MY_PAYMENT_TOKEN/sendPayment' \
--header 'X-Auth-Token: MY_ACCESS_TOKEN' \
--data '{
"method": "PAYCASH",
"expiration_date": "2024-05-09"
}'

Example Response

Header
  Content-Type: application/json
Body
    {
"transaction_status": "PROCESSING",
"payment_token": "42afe884-f047-4452-a3db-65a7de76a9c5",
"paycash_barcode": "2521709744061841",
"paycash_amount": "123.45",
"paycash_barcode_image": "BASE64_ZIPPED_PNG",
"paycash_instructions_link": "",
"refresh_token": "MY_ACCESS_TOKEN"
}
Guatelama

Example Request

200 - Success
    curl --location 'https://api-sandbox.epag.io/payment/MY_PAYMENT_TOKEN/sendPayment' \
--header 'X-Auth-Token: MY_ACCESS_TOKEN' \
--data '{
"method": "PAYCASH",
"expiration_date": "2024-05-09"
}'

Example Response

Header
  Content-Type: application/json
Body
    {
"transaction_status": "PROCESSING",
"payment_token": "42afe884-f047-4452-a3db-65a7de76a9c5",
"paycash_barcode": "2521709744061841",
"paycash_amount": "123.45",
"paycash_barcode_image": "BASE64_ZIPPED_PNG",
"paycash_instructions_link": "",
"refresh_token": "MY_ACCESS_TOKEN"
}
Panama

Example Request

200 - Success
    curl --location 'https://api-sandbox.epag.io/payment/MY_PAYMENT_TOKEN/sendPayment' \
--header 'X-Auth-Token: MY_ACCESS_TOKEN' \
--data '{
"method": "PAYCASH",
"expiration_date": "2024-05-09"
}'

Example Response

Header
  Content-Type: application/json
Body
    {
"transaction_status": "PROCESSING",
"payment_token": "42afe884-f047-4452-a3db-65a7de76a9c5",
"paycash_barcode": "2521709744061841",
"paycash_amount": "123.45",
"paycash_barcode_image": "BASE64_ZIPPED_PNG",
"paycash_instructions_link": "",
"refresh_token": "MY_ACCESS_TOKEN"
}
Peru

Example Request

200 - Success
    curl --location 'https://api-sandbox.epag.io/payment/MY_PAYMENT_TOKEN/sendPayment' \
--header 'X-Auth-Token: MY_ACCESS_TOKEN' \
--data '{
"method": "PAYCASH",
"expiration_date": "2024-05-09"
}'

Example Response

Header
  Content-Type: application/json
Body
    {
"transaction_status": "PROCESSING",
"payment_token": "42afe884-f047-4452-a3db-65a7de76a9c5",
"paycash_barcode": "2521709744061841",
"paycash_amount": "123.45",
"paycash_barcode_image": "BASE64_ZIPPED_PNG",
"paycash_instructions_link": "",
"refresh_token": "MY_ACCESS_TOKEN"
}
Chile

Example Request

200 - Success
    curl --location 'https://api-sandbox.epag.io/payment/MY_PAYMENT_TOKEN/sendPayment' \
--header 'X-Auth-Token: MY_ACCESS_TOKEN' \
--data '{
"method": "PAYCASH",
"expiration_date": "2024-05-09"
}'

Example Response

Header
  Content-Type: application/json
Body
    {
"transaction_status": "PROCESSING",
"payment_token": "42afe884-f047-4452-a3db-65a7de76a9c5",
"paycash_barcode": "2521709744061841",
"paycash_amount": "123.45",
"paycash_barcode_image": "BASE64_ZIPPED_PNG",
"paycash_instructions_link": "",
"refresh_token": "MY_ACCESS_TOKEN"
}
Honduras

Example Request

200 - Success
    curl --location 'https://api-sandbox.epag.io/payment/MY_PAYMENT_TOKEN/sendPayment' \
--header 'X-Auth-Token: MY_ACCESS_TOKEN' \
--data '{
"method": "PAYCASH",
"expiration_date": "2024-05-09"
}'

Example Response

Header
  Content-Type: application/json
Body
    {
"transaction_status": "PROCESSING",
"payment_token": "42afe884-f047-4452-a3db-65a7de76a9c5",
"paycash_barcode": "2521709744061841",
"paycash_amount": "123.45",
"paycash_barcode_image": "BASE64_ZIPPED_PNG",
"paycash_instructions_link": "",
"refresh_token": "MY_ACCESS_TOKEN"
}
Dominican Republic

Example Request

200 - Success
    curl --location 'https://api-sandbox.epag.io/payment/MY_PAYMENT_TOKEN/sendPayment' \
--header 'X-Auth-Token: MY_ACCESS_TOKEN' \
--data '{
"method": "PAYCASH",
"expiration_date": "2024-05-09"
}'

Example Response

Header
  Content-Type: application/json
Body
    {
"transaction_status": "PROCESSING",
"payment_token": "42afe884-f047-4452-a3db-65a7de76a9c5",
"paycash_barcode": "2521709744061841",
"paycash_amount": "123.45",
"paycash_barcode_image": "BASE64_ZIPPED_PNG",
"paycash_instructions_link": "",
"refresh_token": "MY_ACCESS_TOKEN"
}