Payment Methods

Payment Method objects represent your customer's payment instruments. You can use them with Charges to collect payments or save them to Customer objects to store instrument details for future payments.

📄️ Retrieve Payment Methods

<p>Returns a list of Payment Methods attached to a customer.</p>

📄️ Retrieve Payment Method

<p>Returns a single Payment Method.</p> <p>Readable by the owner, an admin, or the account's onboarder (a merchant may read its individuals' payment methods; a partner its merchants'). This endpoint returns the full account number; the list endpoint exposes <code>last4</code> only.</p>

📄️ Delete Payment Method

<p>Deletes a Payment Method.</p>

📄️ Get crypto deposit instructions

<p>Returns the on-chain deposit address for the authenticated account's crypto wallet in the given currency (e.g. <code>BASE-USDC</code>). The wallet is provisioned on demand: if it does not yet exist it is created on demand, provided the account has completed crypto onboarding (KYC). Send USDC to the returned <code>on_chain_address</code> on the returned <code>chain</code>, then poll <code>GET /payment-methods/crypto/{currency}/deposits</code> to see it land.</p>

📄️ List crypto wallet deposits

<p>Returns a paginated, newest-first list of credited deposit activity for the authenticated account's crypto wallet in the given currency. Poll this after sharing deposit instructions to detect an incoming on-chain deposit.</p> <p><code>accountId</code> reads the deposits of an account you onboarded (onboarding relationship).</p>

📄️ Create a card

<p>When you create a new credit card, you must specify a customer or recipient on which to create it.</p>

📄️ Create a bank account

<p>Creates a bank-account payment method. By default the bank account is owned by the authenticated account. Optionally pass <code>account_id</code> to create the bank account on behalf of an account you onboarded (e.g. a player your platform created); authorization is the onboarding relationship.</p>

📄️ Update a bank account's holder address

<p>Corrects the account holder's address on an existing bank account. This is the address forwarded to the banking network when the account is registered, so supplying it resolves links that failed for a missing or unusable address — the registration is retried automatically once the address is saved.</p><p>Only the address can be changed. The routing number, account number and IBAN identify the account and cannot be edited: to correct those, remove the bank account and add it again.</p>

📄️ Remove a bank account

<p>Removes a bank account from the account holder's file.</p><p>An account that is still linked for payouts cannot be removed: the link exists at the banking network as well, and removing it here would not revoke it there. Unlink it from each network first, then remove it.</p>