API Reference

PAYOUTS

Sandbox Gateway Domain URL: https://mapi.yuansferdev.com
Production Gateway Domain URL: https://mapi.yuansfer.com

Payouts API Reference Overview

📘

Read the Payouts Guides and Tutorials

  • Payouts Product Guide and User Flows
  • Tutorial: Payouts API Workflows

Register Payee API

  • Method: POST
  • Endpoint: https://mapi.yuansfer.com/v3/payee/register

Description: This endpoint is used to register a new payee in the Pockyt system. When you initiate this POST request, you will need to include the necessary payee details. In response, Pockyt will provide a customerNo, which is essential for future transactions and identifies the payee within the system.

Retrieve Payee API

  • Method: POST
  • Endpoint: https://mapi.yuansfer.com/v3/payee/retrieve

Description: Retrieve comprehensive information about a registered payee using this endpoint. By submitting a POST request with the payee’s customerNo, you can fetch their account details, which is crucial for account management and validation.

Update Payee API

  • Method: POST
  • Endpoint: https://mapi.yuansfer.com/v3/payee/update

Description: To amend any details associated with a payee's account, utilize this endpoint. It allows you to update information such as the payee's name, address, email, and banking information. On providing the updated details and the payee’s customerNo, you will receive a confirmation of the successful update.

Add Payee Payout Method API

  • Method: POST
  • Endpoint: https://mapi.yuansfer.com/v3/payee/account/create/bank-account

Description: When a payee requires a new bank account to be added as a payout method, this endpoint comes into play. Submit a POST request with the payee’s customerNo and the new bank account details. This action will link the new bank account to the payee's Pockyt profile.

Delete Payee Payout Method

  • Method: POST
  • Endpoint: https://mapi.yuansfer.com/v3/payee/account/delete

Description: The "Delete Payee Funding Account" API endpoint is used to remove a specific funding account from a payee's profile. Simply provide the account's unique identifier to deactivate it from being used for future payouts.

Transfer Payout API

  • Method: POST
  • Endpoint: https://mapi.yuansfer.com/v3/payouts/pay

Description: This endpoint is crucial for executing the actual payout transaction. A POST request triggers the transfer of the specified funds to the payee's account. A successful request results in the processing of the payout.

Foreign Exchange Rate

  • Endpoint: https://mapi.yuansfer.com/v3/payouts/fxrate

Description: Check current foreign exchange rates by hitting this endpoint. It is particularly useful for international payouts where currency conversion is necessary.

Asynchronous Transaction Notification Reference

Description: This section would detail how to configure webhooks to receive asynchronous notifications about the status of transactions, including the setup process and the types of event notifications that can be expected.

Appendix of Response Codes

Description: An exhaustive list and explanation of various response codes that the Payouts API might return. This includes API response message codes, payee registration status codes, bank account registration status codes, and transaction status codes, providing developers with a thorough understanding of the outcomes of their API calls.

Each endpoint in this guide serves a unique function in the payout process, contributing to a streamlined, end-to-end payment solution. Ensure that you follow the specific requirements for each API call, such as providing necessary authentication and parameters, to achieve successful integration and operation.