Pay In - Payment Options

Developing

Develop Env

https://merchant-api.stg.paypaga.com

POST

/transaction-config

Retrieve the current selection of orchestrated Payment Methods with corresponding data requirements. This facilitates the following use cases:

Payment Widget integration (Coming Soon)

Direct API integration

In both use cases, this initialises a transaction intent in the system and assigns a PayPaga Transaction Identifier that will serve as the unique identifier for the lifecycle of the transaction.

Error codes for Pay In Payment Options

Error code	Description
100	Field validation error.
108	The configuration is not available for this merchant.
110	Transaction amount out of range.
500	Unexpected error.
116	Invalid decimals, only 2 decimal places are allowed.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://merchant-api.stg.paypaga.com/transaction-config?sd' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "merchant_id": "06afffd4-8334-4f09-99e3-99046e28737d",
    "country_code": "MX",
    "currency": "MXN",
    "transaction_total": 100.03,
    "merchant_transaction_reference": "merch-001"
}'

Response Example

200 - Success

{
  "transaction_id": "bce580ab-76fd-4ad6-a857-ab2a7b834e43",
  "transaction_date": "2024-01-19",
  "merchant_id": "109b0ced-4871-4113-bcfe-0143750efc7d",
  "country_code": "MX",
  "payment_options": [
    {
      "merchant_country": "Mexico",
      "currency": "MXN",
      "required_fields": [
        {
          "name": "first_name",
          "label": "First Name",
          "type": "string"
        },
        {
          "name": "last_name",
          "label": "Last Name",
          "type": "string"
        }
      ],
      "optional_fields": [
        {
          "name": "email",
          "label": "Email address",
          "type": "string"
        }
      ],
      "payment_method_label": "Pay With Cash",
      "payment_method_code": "PWC",
      "transaction_total": 100.03
    }
  ],
  "currency": "MXN",
  "message": "Transaction Successfully",
  "version": "0.1"
}

Request

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠400Bad Request

🔴500Server Error

Pay In - Direct API Integration

Pay In - Payment Processing