Plexy
Pay API
Gate APISDKDashboard
Pay API
Gate APISDKDashboard
  1. Payouts
  • Overview
  • Authorization
  • Webhooks
  • API Errors
  • Test Scenarios
  • Ecommerce Plugins
  • API
    • Payments
      • Overview
      • Payment Links
        • Create Payment Link
        • List Payment Links
        • Retrieve Payment Link by Order Reference
        • Cancel Payment Link
        • Retrieve Payment Link
        • Update Payment Link Expiration
        • Retrieve Payment Links Statistics
      • Reccurent Payments
        • Create Merchant-Initiated Payment
      • Direct Payments
        • Get Keys
        • Create Host-to-Host Payment
      • Transaction Management
        • Find Transaction's History by ID
        • Find Transaction by Payment Link ID
        • Find Transaction by ID
        • Find Transaction by Order reference
      • Payment Management
        • Cancel Payment
        • Capture Payment
        • Process Refund
      • Split Requests
        • Create
        • List
        • Update
        • Get By Id
        • Delete
    • Payouts
      • Retrieve Payout Transactions
        GET
      • Process Payout
        POST
      • Save Card for Payouts
        POST
    • Customers
      • Get Customer's Card Tokens
      • List Customers
      • Create Customer
      • Get Customer by ID
      • Get Customer's Transactions
    • Merchants
      • Payment Beneficiary
        • Create
        • Update
        • Gey By Id
        • List
        • Transfer from beneficiary balance to merchant balance
        • Create manual settlement for beneficiary
      • Retrieve Merchant's Details
    • Wallet
      • Authorize
      • Сapture
      • Refund
      • Cancel
    • Payment Methods
      • Google Pay™ Integration
  • Schemas
    • Schemas
      • response.TransactionList
      • entity.SplitRequest
      • entity.PaymentBeneficiary
      • request.CreatePaymentBeneficiary
      • entity.SettlementPaymentOrder
      • entity.PayoutRequest
      • entity.PayoutRequestRowData
      • entity.UserProfile Copy
      • entity.Store
      • request.AssignStoreToUser
      • request.RemoveStoreFromUser
      • entity.AccountExternalSystem
      • response.AssignStoreToUser
      • request.CreateStore
      • response.Store
      • response.UserList
      • request.WalletAuthorizeRequest
      • entity.ShortWalletTransaction
      • response.WalletAuthorizeResponse
      • request.WalletCapture
      • response.RemoveStoreFromUser
      • command.HandleThreeDResult
      • domain.Report
      • entity.CardSaveSessionCustomer
      • entity.Permission
      • entity.UserProfile
      • entity.UserRole
      • errors.Message
      • errors.Source
      • errors.Type
      • git_plexypay_com_ecom_back_api_internal_domain_view.Page-domain_Report
      • git_plexypay_com_ecom_back_api_internal_domain_view.Page-entity_UserProfile
      • git_plexypay_com_ecom_back_api_internal_platform_errors.Code
      • models.CSVApiRequest
      • models.CreateBussinessDetails
      • models.KeyResponse
      • models.OnboardingRequest
      • models.Transaction
      • paymentcore.Address
      • paymentcore.CustomerDetails
      • request.AuthorizePayment
      • request.BrowserDetails
      • request.CardData
      • request.ChangeUserRole
      • request.ContinueThreeDS
      • request.CreateCardSaveSession
      • request.CreateInviteSession
      • request.CreatePaymentLink
      • request.CreatePaymentLinkMetadata
      • request.HandlePayout
      • request.MerchantInitiatedPayment
      • request.PasswordRequest
      • request.Recurring
      • request.RefundPayment
      • request.SaveCard
      • request.SaveOneCustomer
      • request.TwoStepAuthorizePayment
      • request.UpdateMerchantSettingsRequest
      • request.UpdatePaymentLink
      • response.AcquirerResponseThreeDSecure
      • response.AuthorizeAndCapturePayment
      • response.AuthorizePayment
      • response.CancelPaymentResponse
      • response.CapturePaymentResponse
      • response.ContinueThreeDS
      • response.Currency
      • response.Customer
      • response.CustomerTransaction
      • response.CustomerTransactions
      • response.Customers
      • response.Error
      • response.Merchant
      • response.MerchantInitiatedPayment
      • response.MerchantSettings
      • response.PaymentLink
      • response.PaymentLinkInfo
      • response.PaymentLinkMetadata
      • response.PaymentLinksInfo
      • response.PaymentLinksStatistics
      • response.PaymentLinksStatisticsItem
      • response.Payout
      • response.Permission
      • response.RefundPaymentResponse
      • response.Report
      • response.SavedCard
      • response.Session
      • response.Settlement
      • response.SettlementTransaction
      • response.Store
      • response.Stores
      • response.Transaction
      • response.TransactionDetails
      • response.TransactionEvents
      • response.TransactionHistoryEvent
      • response.TransactionHistoryEventData
      • response.TransactionResponse
      • response.TransactionWebhookDetails
      • response.Transactions
      • response.UpdateMerchantSettingsResponse
      • response.UserProfile
      • value.PaymentMethod
    • receipt
    • Error
    • DecimalAmount
    • ProductType
    • ProductCategory
    • Product
    • Order
    • AgentBalance
    • AgentDeposit
    • TopupRequest
    • CreateOrderRequest
  1. Payouts

Save Card for Payouts

POST
https://api.plexypay.com/v1/cards
Initializes a session for saving a customer’s card and redirects to a hosted checkout. This method does not validate the card via bank transaction.
On successful card save a webhook will be sent to the merchant server.
{
	"cardTokenId": "4400439852115243",
	"email": "john@plexy.money",
	"externalId": "123456",
	"fullName": "John Doe",
	"lastFour": "3131"
}

Request

Authorization
API Key
Add parameter in header
Authorization
Example:
Authorization: ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Body

🟠400Bad Request
🔴500Internal Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.plexypay.com/v1/cards' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cardSaveCancelUrl": "string",
    "cardSaveFailUrl": "string",
    "cardSaveSuccessUrl": "string",
    "createCustomer": {
        "email": "string",
        "externalId": "string",
        "phoneNumber": "string"
    },
    "customerId": "string"
}'
Response Response Example
200 - Example 1
{
    "cardSaveUrl": "https://checkout.plexypay.com/c/s/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXNzaW9uIjp7ImlkIjoiMDE5ZDZiZTctMjgzNC03OWZhLTgyM2EtOThhYzQ4MDEzOWIyIiwiY3VzdG9tZXIiOnsiZXh0ZXJuYWxJZCI6IjEyMzQ1NiIsImVtYWlsIjoiYXNwYW5AbWFpbC5ydSIsInBob25lTnVtYmVyIjoic3RyaW5nIn0sIm1lcmNoYW50SWQiOiIxZjA3MTg5NC03ZGY3LTQyYzEtYTljOC0wMzliODc2Y2E1OTIiLCJzdG9yZUlkIjoiMGI0ZmI1ZGEtYTBiNS00ZTA1LTk2MDUtZDhhNjFiMzAwYWYzIiwibWVyY2hhbnROYW1lIjoiVE9PIFBMRVhZIFBMQVRGT1JNIiwiY3JlYXRlZEF0IjoiMjAyNi0wNC0wOFQwNzowMzoyNC40Njg2NTQxMDZaIiwiZXhwaXJlc0F0IjoiMjAyNi0wNC0wOFQwNzozMzoyNC40Njg2NTQxMDZaIiwiY2FuY2VsVXJsIjoic3RyaW5nIiwic3VjY2Vzc1VybCI6InN0cmluZyIsImZhaWx1cmVVcmwiOiJzdHJpbmcifSwiaXNzIjoiUExFWFlfU0VTU0lPTlNfU0VSVklDRSIsInN1YiI6IlBMRVhZX0NIRUNLT1VUX1BBWU1FTlRTIiwiYXVkIjpbIlBMRVhZX0NIRUNLT1VUX1BBWU1FTlRTIl0sImV4cCI6MTc3NTYzMzYwNCwibmJmIjoxNzc1NjMxODA0LCJpYXQiOjE3NzU2MzE4MDQsImp0aSI6IjAxOWQ2YmU3LTI4MzQtNzlmYS04MjNhLTk4YWM0ODAxMzliMiJ9.U49TzAfnil34pNoQOevYvWqIbEJu5wzSGJHTIsu2NMI%11"
}
Modified at 2026-04-08 09:41:11
Previous
Process Payout
Next
Get Customer's Card Tokens
Built with