Guides

Payouts Integrations Guide

Suggest Edits

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 API Workflow Tutorial

This tutorial outlines the typical steps involved in the workflow of Pockyt's Payouts service. The process encompasses everything from registering a payee to executing a payout and managing subsequent notifications.

  1. Registering a Payee:

    • The first step involves adding a payee to the system. This process includes creating a unique identifier for the payee, known as a customerNo.

  2. Adding a Payout Method:

    • Once the payee is registered, the next step is to associate a bank account or another applicable payment method with them. This is identified in the system as an accountToken.

  3. Executing a Payout:

    • With the payee and their payout method set up, the next phase is to initiate the actual payout transaction.

  4. Handling Notifications:

    • The final step involves managing asynchronous notifications to keep track of the payout status.

This workflow provides a clear and concise overview of the essential steps required to effectively utilize Pockyt's Payouts API, from the initial setup to the execution and monitoring of payouts.

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.

Updated 8 months ago