Rapyd Docs and API Reference
Docs
API Reference
Changelog
Plugins
Client Portal Guide
Community
Support
Client Login
v172.01
v172.01
stable
Home
Guides
API Reference
Changelog
Home
Guides
Recipes
API Reference
Reference
Changelog
Discussions
Page Not Found
Search
{{ state.current().meta.title }}
API Logs
Home
Guides
API Reference
Changelog
{{search.symbol}}K
discard
Save Edits
Submit
Suggested Edits
Rapyd Docs
Get Started
Postman Collection
Rapyd Platforms
Payment / Payout Method Types
Use Cases
First API Call
Activating Your Account (KYB)
Developer Champions
YouTube Tutorials
Rapyd Code Samples
Rapyd Collect
Rapyd Collect Overview
Rapyd Checkout Overview
Hosted Checkout Page Integration
Checkout Toolkit Integration
Complete Payment
Save Card Details With Rapyd Checkout
Integrate Payment Methods
Card Payments
Card Payment With 3DS Verification
Card on File
Card on File With 3DS Verification
Card to Card Payments
Bank Direct Debit
Bank Transfers
Bank Redirect
Cash Payments
eWallets
Billing
Subscriptions
Mass Invoices
Payment Features
Two-Step Payment
Payment With FX
Split Payment by Amount
Group Payments
Escrow
Canceling an Escrow
Partial Payments
Virtual Account Numbers
Modify Payments
Canceling a Payment
Refunds
Partial Refunds
Refund to Multiple Accounts
Payment Method Types
Payment Types Overview
Americas
Boleto Bancário
Cash Payment MX
SPEI
Cash Collection El Salvador
APAC
Alipay
BancNet
CIMB Bank
DANA
FAST
GrabPay
Maybank
PayNow
PayTM
PhonePe
POLi
PromptPay
UPI
UnionPay
QRIS
TrueMoney
GCash
EMEA
Apple Pay
Giropay
Google Pay™
iDEAL
Trustly
Global
Visa
Mastercard
Rapyd Disburse
Rapyd Disburse Overview
Funding Your Client Wallet
Mass Payouts Overview
Rapyd Disburse Features
Payout With FX
Reusing Beneficiary or Sender
Validating Beneficiary Details
Recurring Payouts
Beneficiary Account Details
Canceling a Payout
Service Providers
Paying Utility Bills
Top-Up Payment
Payout Method Types
Rapyd Disburse Payout Methods
Payout to a Bank Account
ACH Payout
Payout to a Card
Cash Payout
Rapyd Wallet
Rapyd Wallet Overview
Wallet Contact
Creating a Rapyd Wallet
Identity Verification
Hosted IDV Page and Toolkit
Funding a Wallet
Wallet Features
Balances
Moving Funds Between Wallets
Rapyd Verify Hosted Page
Rapyd Verify API
Rapyd Issuing
Rapyd Issuing Overview
Cards
Hosted Page for Virtual Cards
Authorization
Load and Spend Authorization
Remote Authorization
Setting Up a Remote Authorization Server
Authorizing a Card Transaction Remotely
Rapyd Point of Sale
Point-of-Sale Locations
Withdrawing Cash
Reversing a Withdrawal
Depositing Cash to Wallet
Client Support
Client Support
Creating a Customer Support Ticket
Viewing Support Tickets
Rapyd Docs
Get Started
Postman Collection
Rapyd Platforms
Payment / Payout Method Types
Use Cases
First API Call
Activating Your Account (KYB)
Developer Champions
YouTube Tutorials
Rapyd Code Samples
Rapyd Collect
Rapyd Collect Overview
Rapyd Checkout Overview
Hosted Checkout Page Integration
Checkout Toolkit Integration
Complete Payment
Save Card Details With Rapyd Checkout
Integrate Payment Methods
Card Payments
Card Payment With 3DS Verification
Card on File
Card on File With 3DS Verification
Card to Card Payments
Bank Direct Debit
Bank Transfers
Bank Redirect
Cash Payments
eWallets
Billing
Subscriptions
Mass Invoices
Payment Features
Two-Step Payment
Payment With FX
Split Payment by Amount
Group Payments
Escrow
Canceling an Escrow
Partial Payments
Virtual Account Numbers
Modify Payments
Canceling a Payment
Refunds
Partial Refunds
Refund to Multiple Accounts
Payment Method Types
Payment Types Overview
Americas
Boleto Bancário
Cash Payment MX
SPEI
Cash Collection El Salvador
APAC
Alipay
BancNet
CIMB Bank
DANA
FAST
GrabPay
Maybank
PayNow
PayTM
PhonePe
POLi
PromptPay
UPI
UnionPay
QRIS
TrueMoney
GCash
EMEA
Apple Pay
Giropay
Google Pay™
iDEAL
Trustly
Global
Visa
Mastercard
Rapyd Disburse
Rapyd Disburse Overview
Funding Your Client Wallet
Mass Payouts Overview
Rapyd Disburse Features
Payout With FX
Reusing Beneficiary or Sender
Validating Beneficiary Details
Recurring Payouts
Beneficiary Account Details
Canceling a Payout
Service Providers
Paying Utility Bills
Top-Up Payment
Payout Method Types
Rapyd Disburse Payout Methods
Payout to a Bank Account
ACH Payout
Payout to a Card
Cash Payout
Rapyd Wallet
Rapyd Wallet Overview
Wallet Contact
Creating a Rapyd Wallet
Identity Verification
Hosted IDV Page and Toolkit
Funding a Wallet
Wallet Features
Balances
Moving Funds Between Wallets
Rapyd Verify Hosted Page
Rapyd Verify API
Rapyd Issuing
Rapyd Issuing Overview
Cards
Hosted Page for Virtual Cards
Authorization
Load and Spend Authorization
Remote Authorization
Setting Up a Remote Authorization Server
Authorizing a Card Transaction Remotely
Rapyd Point of Sale
Point-of-Sale Locations
Withdrawing Cash
Reversing a Withdrawal
Depositing Cash to Wallet
Client Support
Client Support
Creating a Customer Support Ticket
Viewing Support Tickets
Rapyd API Reference
API Reference
Rapyd Overview
Rapyd Platform
Code Samples
Information Security
Message Security
Idempotency
Request Signatures
Webhooks
Webhook Format
Webhook Security
Webhook Signatures
Error Messages
General Errors
File Errors
Card Network Error Messages
Foreign Exchange Errors
Hosted Page Errors
Card Transaction Errors
Hosted Page Language Support
get
List Hosted Page Supported Languages
Quarantine Object
Webhook - Quarantine Under Review
Webhook - Quarantine Declined
Webhook - Quarantine Released
Rapyd Collect
Rapyd Collect Overview
Payment Object
Payment Fees Object
Outcome Object
Client Details Object
Wallets Array
Payment Method Data Object
Creating a Split Payment
Creating a Card Payment With 3DS Authentication
Customizing Hosted Pages with Google Pay
Creating a Google Pay Payment on a Customized Checkout Page
Customizing Hosted Pages with Apple Pay
Creating an Apple Pay Payment on a Customized Checkout Page
Card Payment Message Sequences
Card Payment With Delayed Capture Message Sequences
Cash Payment Message Sequences
Bank Redirect Payment Message Sequences
Bank Transfer Payment Message Sequences
post
Create Payment
post
Update Payment
post
Capture Payment
post
Complete Payment
get
Retrieve Payment
delete
Cancel Payment
get
List Payments
Webhook - Payment Captured
Webhook - Payment Completed
Webhook - Payment Expired
Webhook - Payment Failed
Webhook - Payment Reversed
Payment Errors
Group Payment Object
Group Payments
Creating a Group Payment
post
Create Group Payment
get
Retrieve Group Payment
delete
Cancel Group Payment
post
Create Group Refund
Webhook - Group Payment Completed
Group Payment Errors
Digital Wallet Object
post
Retrieve Apple Pay Session
Escrow Object
Escrows
get
Retrieve Escrow
post
Release Funds from Escrow
get
List Escrow Releases
Webhook - Escrow Released
Escrow Errors
Refund Object
Refunds
Refund Message Sequences
post
Create Refund
post
Update Refund
post
Complete Refund
get
Retrieve Refund
get
List Refunds
get
List Refunds by Payment ID
Webhook - Refund Completed
Webhook - Refund Rejected
Refund Errors
Dispute Object
get
Retrieve Dispute
get
List Disputes
Webhook - Dispute Created
Webhook - Dispute Updated
Customer Object
Customers
post
Create Customer
post
Update Customer
get
List Customers
get
Retrieve Customer
delete
Delete Customer
delete
Delete Discount from Customer
Webhook - Customer Created
Webhook - Customer Updated
Webhook - Customer Deleted
Customer Errors
Address Object
Addresses
post
Create Address
post
Update Address
get
Retrieve Address
Address Errors
Payment Method Type Object
get
List Payment Methods by Country
get
Get Payment Method Required Fields
Payment Method Errors
Customer Payment Method Object
Add Payment Method Sequence
post
Add Payment Method to Customer
post
Update Payment Method
get
Retrieve Payment Method
get
List Payment Methods of Customer
delete
Delete Payment Method
Webhook - Payment Method Canceled
Webhook - Payment Method Failed
Webhook - Card Added Failure
Webhook - Customer Payment Method Created
Customer Payment Method Errors
Tokens
Bank Account Token Object
PII Token Object
post
Create Token
get
Retrieve a Token
Token Errors
Hosted Page Card Token Object
post
Create Card Token - Hosted Page
Sample Page for Saving Card Details
Hosted Page Token Errors
Card-to-Card Object
post
Add Source Card
Adding the Source Card Details - Hosted Page
post
Create Card-to-Card Payment
Adding the Card-to-Card Payment Details
Product Object - Collect
post
Create Product
post
Update Product
get
Retrieve Product
get
List Products
delete
Delete Product
Product Errors
Card-to-Card Payment Errors
SKU Object
post
Create SKU
post
Update SKU
get
Retrieve SKU
get
List SKUs
delete
Delete SKU
SKU Errors
Plan Object - Collect
Pricing Plans
post
Create Plan
post
Update Plan
get
Retrieve Plan
get
List Plans
delete
Delete Plan
Plan Errors
Subscription Object - Collect
Billing Period Calculations
post
Create Subscription
post
Update Subscription
post
Complete a Cycle
post
Start a New Cycle
get
Retrieve Subscription
get
List Subscriptions
delete
Cancel Subscription
delete
Delete Discount from Subscription
Webhook - New Cycle Started - Collect
Webhook - Subscription Updated - Collect
Webhook - Subscription Unpaid - Collect
Webhook - Subscription Canceled - Collect
Subscription Errors
Subscription Item Object - Collect
post
Create Subscription Item
post
Update Subscription Item
get
Retrieve Subscription Item
get
List Subscription Items
delete
Delete Subscription Item
Subscription Item Errors
Usage Record Object
post
Create Usage Record
get
List Usage Records
Usage Record Errors
Coupon Object
post
Create Coupon
post
Update Coupon
get
Retrieve Coupon
get
List Coupons
delete
Delete Coupon
Coupon Errors
Discount Object
get
Retrieve Discount - Customer
get
Retrieve Discount - Subscription
Order Object
post
Create an Order
post
Update Order
post
Pay an Order
get
Retrieve an Order
get
List Orders
Webhook - Order Payment Failed
Webhook - Order Updated
Order Errors
Return Object
post
Create a Return Against an Order
get
Retrieve a Return
get
List Returns
Return Errors
Invoice Object
post
Create Invoice
post
Update Invoice
post
Finalize Invoice
post
Pay Invoice
post
Void Invoice
post
Mark Invoice Uncollectible
get
Retrieve Invoice
get
Retrieve Invoice Lines from Invoice
get
Retrieve Upcoming Invoice
get
Retrieve Invoice Lines from Upcoming Invoice
get
List Invoices
delete
Delete Invoice
Webhook - Invoice Created
Webhook - Invoice Updated
Webhook - Invoice Finalized
Webhook - Invoice Payment Created
get
Retrieve Invoice Item
Webhook - Invoice Payment Succeeded
Webhook - Invoice Payment Failed
Invoice Errors
Invoice Item Object
post
Create Invoice Item
post
Update Invoice Item
get
List Invoice Items
delete
Delete Invoice Item
Invoice Item Errors
Checkout Page Object
Custom Elements Object
Configuring List of Payment Methods
post
Create Checkout Page
Sample Checkout Pages
get
Retrieve Checkout Page
Checkout Errors
Rapyd Protect Errors - Rapyd Authorization
Rapyd Protect Errors - Remote Authorization
Rapyd Disburse
Rapyd Disburse Overview
Payout Object
Payout Fees Object
Payout to Card Message Sequences
Payout to Bank Message Sequences
Payout to Cash Message Sequences
Payout With FX Message Sequences
post
Create Payout
post
Confirm Payout with FX
post
Complete Payout
get
Retrieve Payout
delete
Cancel Payout
get
List Payouts
Webhook - Payout Completed
Webhook - Payout Expired
Webhook - Payout Failed
Webhook - Payout Returned
Payout Errors
Payout Method Type Object
get
List Payout Method Types
get
Get Payout Required Fields
Sender Object
post
Create Sender
get
Retrieve Sender
delete
Delete Sender
Beneficiary Object
post
Create Beneficiary
post
Validate Beneficiary
get
Retrieve Beneficiary
delete
Delete Beneficiary
Additional Sender and Beneficiary Fields
Beneficiary Tokenization Page Object
post
Create Beneficiary Tokenization Page
Sample Beneficiary Tokenization Pages
Beneficiary Tokenization Errors
Webhook - Beneficiary Created
Subscription Object - Disburse
post
Create Subscription - Disburse
post
Update Subscription - Disburse
get
Retrieve Subscription - Disburse
get
List Subscriptions - Disburse
delete
Cancel Subscription - Disburse
Payout Subscription Errors
Plan Object - Disburse
Create Plan - Disburse
Product Object - Disburse
Create Product - Disburse
Service Provider Object
get
List Service Providers
get
Retrieve Service Provider Details
post
Validate Service Provider Account
post
Pay Service Provider
post
Check Consumer Account Balance
Webhook - Service Provider Payment Completed
Service Provider Errors
Rapyd Wallet
Rapyd Wallet Overview
Wallet Object
post
Create Wallet
put
Update Wallet
put
Disable Wallet
put
Enable Wallet
get
Retrieve Wallet
get
List Wallets
delete
Delete Wallet
Webhook - Wallet Enabled
Webhook - Wallet Disabled
Webhook - Wallet Deleted
Wallet Errors
Wallet Contact Object
post
Add Contact to Wallet
post
Update Wallet Contact
get
Retrieve Wallet Contact
get
List Contacts for a Rapyd Wallet
get
Retrieve Compliance Profile of Contact
delete
Delete Wallet Contact
Wallet Contact Errors
Wallet Transaction Object
Transaction Types
Wallet Limit Object
Action Data Object
Wallet Balance Types
post
Transfer Funds Between Wallets
post
Set Transfer Response
post
Put Funds on Hold
post
Release On-Hold Funds
post
Set Wallet Account Limit
delete
Delete Wallet Account Limit
get
List Wallet Transactions
get
Retrieve Wallet Balances
get
Get Details of Wallet Transaction
Webhook - Funds Added
Webhook - Funds Removed
Webhook - Transfer Funds Between Wallets Created
Webhook - Transfer Funds Between Wallets Response
Webhook - Transfer Request
Webhook - Transfer Completed
Wallet Transaction Errors
Transaction Limit Object
Webhook - Transaction Limit Changes - Beta
Identity Verification Object
post
Verify Identity
get
List Official Identification Documents
Webhook - Identity Verification
Identity Verification Errors
Hosted Page Identity Verification Object
Sample Hosted Identity Verification Page
post
Create Identity Verification Page
Hosted Page Identity Verification Errors
Virtual Account Number Object
post
Issue Virtual Account Number to Wallet
post
Simulate a Bank Transfer to a Wallet
get
List Capabilities of Virtual Accounts per Country
get
Retrieve Virtual Account History
get
Retrieve Virtual Account Transaction
get
List Virtual Accounts by Rapyd Wallet
get
Retrieve Remitter Details
Webhook - Deposit Completed
Virtual Account Number Errors
Rapyd Verify Overview - Beta
Rapyd Verify JSON Application Object
post
Create Application
post
Add Subsection
post
Upload Document
post
Save Application
post
Submit Application
get
List Application Types by Country
get
Retrieve Application Type
get
Retrieve Application by Wallet ID
get
Retrieve Application
get
Retrieve Application Lite
get
Retrieve Application Section
get
Retrieve Application Status
get
List Identification Documents for Verification
delete
Delete Subsection
delete
Delete Document
Webhook - Application Status Change
Rapyd Verify Errors
Rapyd Verify Hosted Page Object
Merchant Details Object
Organization Details Object
Rapyd Verify Hosted Page Images
post
Create Hosted Application
get
Retrieve Hosted Application
Filling Out a Hosted Application - Sole Proprietor
Filling Out a Hosted Application - Company
Rapyd Issuing
Rapyd Issuing Overview
Issued Card Object
post
Issue Card
post
Activate Issued Card Using API
post
Update Card Status
post
Set PIN Code
post
Personalize Issued Card
get
List Issued Cards
get
Retrieve Issued Card Details
post
Simulate Blocking a Card
Webhook - Bulk-Issued Card Personalized
Webhook - Issued Card Activated
Webhook - Issued Card PIN Set
Webhook - Card Issuing Blocked
Card Details Object
post
Display Issued Card Details to Customer
Rapyd Authorization Object
post
Simulate a Card Adjustment
post
Simulate a Card Refund
Webhook - Card Issuing Adjustment
Webhook - Card Issuing Refund
Webhook - Card Issuing Reversal
Webhook - Card Issuing Sale
Webhook - Authorization Declined
Rapyd Authorization Errors
Remote Authorization Object
post
Simulate a Card Authorization Request
post
Simulate a Card Authorization Reversal
Webhook - Remote Authorization Successful
Webhook - Remote Authorization Reversed
Issued Card Transaction Object
get
List Issued Card Transactions
get
Retrieve Issued Card Transaction Details
Hosted Card Activation Page Object
post
Activate Issued Card Using Hosted Page
Sample Pages for Activating Issued Card
post
Reset PIN Code Using Hosted Page
Issued Card Errors
Metadata
Metadata Object
Metadata Errors
Resource Methods
Resource Methods
Country Object
get
List Countries
Daily Rate Object
get
Get Daily Rate
Currency Object
get
List Currencies
Location Object
get
Retrieve Rapyd POS Location
get
List Rapyd POS Locations
get
List Rapyd POS Locations by Coordinates
get
List Rapyd POS Locations by Coordinates - Cluster-Based
Location Errors
Testing
Testing for Payments API
Card Numbers for Testing
Error Simulation
Simulated Errors
Simulating 3DS Authentication
Simulating 3DS Authentication - API Method
Simulating 3DS Authentication - Hosted Page
Simulating Cardholder Disputes
Simulating Hosted Application Responses
Add Funds and Remove Funds Transactions
post
Add Funds to Wallet Account
post
Remove Funds From Wallet Account
get
Get Details of Add Funds Request
get
Get Details of Remove Funds Request
Sample Image
Point-of-Sale API
Point-of-Sale API Overview
Sessions
post
Open Session
post
Close Session
get
Echo the Platform
Deposit and Pay
post
Deposit
get
Pay
Use Paycode
get
Get Paycode Details
Webhook - Payment Completion
Webhook - Payment Confirmation
Webhook - Deposit Confirmation
Webhook - Deposit Completed
Withdrawal
post
Withdraw
post
Reverse Withdrawal
Webhook - Withdraw Completed
Webhook - Withdraw Reversal
Glossary
Glossary