Skip to main content

16 posts tagged with "release"

View All Tags

· 3 min read

Changelog​

Updates​

General​

  • Update: The Developers -> Shop section has been updated to include the ability to specify separate webhook URLs for orders (payment acceptance) and for payouts.
  • New feature: Added a new callback for payouts, enhancing the integration options for payout functionalities.

Orders​

  • Update: A new parameter acquirerCode has been added to the paymentSettings object of the Create Order endpoint.
  • Update: New possible parameters transferType and purpose have been added to the payments array in the paymentDetails object of the Retrieve Order Details endpoint. These are used for instrumentType=bank_transfer.
  • Update: A new mandatory parameter acquirerCode has been added to the response of the Retrieve Payment Methods endpoint.

Payouts​

Changes expected in the next release​

danger

The callback for orders will change in the next release (14.05.2024) without backward compatibility.

Lines highlighted will be removed from the webhook in the next release.

{
  "id": 77,
  "number": "7_1706275173",
  "status": "in_progress",
  "cost": {
    "amount": "56.99",
    "currency": "USD"
  },
  "timeLimit": {
    "date": "2024-01-27 07:45:51.000000",
    "timezone_type": 3,
    "timezone": "UTC"
  },
  "orderCreatedAt": {
    "date": "2024-01-26 13:19:33.222170",
    "timezone_type": 3,
    "timezone": "UTC"
  },
  "orderPaidAt": {
    "date": "2024-01-26 13:19:33.222170",
    "timezone_type": 3,
    "timezone": "UTC"
  },
  "captureNeeded": false,
  "payments": [
    {
      "id": "79",
      "type": "payment",
      "parentPaymentId": "83",
      "cost": {
        "amount": "56.99",
        "currency": "USD"
      },
      "acquirerCode": "fyst",
      "paymentMethod": "card",
      "paymentDetails": {
        "type": "card",
        "authCode": "auth94753457343",
        "rrn": "rrn583743856734",
        "maskedCardNumber": "123456******1234"
      }
    }
  ],
  "customer": {
    "id": 13,
    "name": "John",
    "middleName": "James",
    "surname": "Doe",
    "phone": "79221110500",
    "email": "john.doe@mymail.com"
  },
  "data": {
    "shopId": 123,
    "orderNumber": "56573FDFVFDBWF",
    "orderStatus": "in_progress",
    "cost": {
      "amount": "56.99",
      "currency": "USD"
    },
    "timeLimit": "2023-08-29T15:34:56+03:00",
    "orderCreatedAt": "2023-08-29T15:34:56+03:00",
    "orderPaidAt": "2023-08-29T15:34:56+03:00",
    "autoCapture": true,
    "payments": [
      {
        "paymentId": "79",
        "paymentType": "payment",
        "parentPayment": "83",
        "cost": {
          "amount": "56.99",
          "currency": "USD"
        },
        "acquirer": {
          "code": "fyst"
        },
        "instrumentType": "card",
        "paymentDetails": {
          "authCode": "auth94753457343",
          "maskedCardNumber": "123456******1234",
          "rrn": "rrn583743856734"
        }
      }
    ],
    "customer": {
      "customerId": "56656",
      "firstName": "John",
      "lastName": "Doe",
      "middleName": "James",
      "phone": "79221110500",
      "email": "john.doe@mymail.com"
    }
  }
}

· One min read

Changelog​

Bug Fixes​

  • Corrected in Retrieve Order Details and Callback: Fixed an issue where the autoCapture parameter was incorrectly displayed for one-stage payments. It now correctly reflects true for one-stage payments where funds are automatically captured, aligning with the documentation.

New Features​

  • Added to Create Order Request: A new object redirectUrls has been introduced, allowing specification of URLs for redirecting users after successful or unsuccessful payment transactions. This ensures a better user experience by clearly guiding the customers following payment processing.

· One min read

Changelog​

New Features​

  • Added: Payouts are now fully supported with four new refactored endpoints for handling payout processes.
    • Create Payout Request: New endpoint to initiate a new payout request.
    • Retrieve Payout Status: New endpoint to retrieve the current status of a specific payout operation for a shop.
    • Retrieve Payout Methods: New GET endpoint to retrieve the list of payout methods available for a given shop, identified by its {shopId}. This endpoint provides an unfiltered list of all payout methods applicable to the shop.
    • Retrieve Required Payout Fields: New endpoint to retrieve necessary data fields for initiating a payout through a specific provider.

Updates​

  • Update: The Retrieve Order Details endpoint has been updated to include shopId and orderNumber parameters.
  • Update: The format of the Callback has been synchronized with the response of the Retrieve Order Details. This change was made while preserving backward compatibility.
    Note: In the next release, backward compatibility will be removed, and the Callback will only return the data object, making its format fully identical to the Retrieve Order Details endpoint.

· 2 min read

Changelog​

New Features​

  • Added: New endpoint Retrieve Payment Methods to retrieve payment methods.

    • Details: The new endpoint allows merchants to fetch all available payment methods for a specified shop via its shopId. The information obtained serves to fill the paymentSettings object with necessary data during the order creation process.

  • Added: Payouts are now supported with three new endpoints for handling payout processes.

    • Create Payout Request: New endpoint to initiate a new payout request.
      • Details: Merchants can now initiate payout requests.
    • Retrieve Payout Status: New endpoint to retrieve the current status of a specific payout operation for a shop.
      • Details: This endpoint provides the ability to check the status of a payout operation.
    • Retrieve Required Payout Fields: New endpoint to retrieve necessary data fields for initiating a payout through a specific provider.
      • Details: Merchants can retrieve the required fields for the recipient object necessary for initiating a payout, specific to a provider and instrument type.

Updates​

  • Update: In the Create Order endpoint, the orderNumber parameter is now mandatory for creating an order.
    • Details: The orderNumber serves as a unique identifier for the order, which you need to generate. It must be specific to the shopId and unique for each order within that shopId.

· One min read

Changelog​

Access to our Test and Production IP Addresses​

  • Update: You can now obtain the IP addresses of our test and production environments directly from the merchant developer panel. This enables you to easily whitelist our IP addresses if you wish to secure your integration further.
  • How to Access: For detailed instructions, visit this guide.
caution

Upcoming Change in the Next Release

Create Order Endpoint Update​

  • Update: In the Create Order endpoint, the orderNumber parameter will become mandatory when creating an order.
    • Details: The orderNumber is a unique identifier for the order that you must generate on your side. It should be specific to the shopId and must be unique for every order within each shopId.

· One min read

Changelog​

Retrieve Order Details Endpoint / Callback Modification​

Create Order Endpoint Changes​

  • Endpoint: Create Order Endpoint
  • Modifications:
    • Removed object: paymentPageSettings object has been removed.
    • New object added: Introduced paymentPageDesign as a replacement.
    • Mandatory parameter: orderNumber is now a required parameter.
    • Customer object update: The customer object now requires firstName and lastName as mandatory parameters.
    • Payment settings enhancement: In the paymentSettings object, within the entryMode parameter, redirect has been added as a new enum option.

iFrame Payment Page Display Capability​

  • Feature: Enabled displaying the payment page using an iFrame.
  • Documentation: For more details, visit Gateway Developers.