oceafin
    • Oceafin Partner API V1
    • Getting Started
    • Authentication
    • Customers And Onboarding
    • Product Workflows
    • Webhooks
    • Errors
    • Partner Customers
      • Create partner customer
        POST
      • Upload or link a file to a partner customer
        POST
      • Submit partner-attested KYC or KYB evidence
        POST
      • List partner customer balances
        GET
      • List partner customer transactions
        GET
      • Get partner transaction
        GET
    • Partner Conversion
      • List partner conversion quotes
        GET
      • Create partner conversion quote
        POST
      • Get partner conversion quote
        GET
      • List partner conversions
        GET
      • Create partner conversion approval draft
        POST
      • Get partner conversion
        GET
    • Partner Fiat
      • Get partner fiat account capabilities
        GET
      • Create partner fiat account application
        POST
      • Submit additional information for a partner fiat account application
        POST
      • List partner fiat accounts
        GET
      • Get partner fiat deposit instructions
        GET
      • List partner fiat deposits
        GET
      • Get partner fiat deposit
        GET
      • List partner bank accounts
        GET
      • Create partner bank account
        POST
      • Get partner fiat withdrawal capabilities
        GET
      • Activate partner fiat withdrawal capability
        POST
      • Submit fiat withdrawal capability activation additional information
        POST
      • Create partner fiat withdrawal quote
        POST
      • Create partner fiat withdrawal approval draft
        POST
      • List partner fiat withdrawals
        GET
      • Submit an approved partner fiat withdrawal for processing
        POST
      • Submit additional information for a partner fiat withdrawal
        POST
      • Get partner fiat withdrawal
        GET
    • Partner Crypto
      • List partner crypto deposit wallets
      • List partner crypto deposits
      • Get partner crypto deposit
      • Submit partner crypto deposit Travel Rule information
      • Create partner crypto withdrawal quote
      • List partner crypto wallet beneficiaries
      • Create partner crypto wallet beneficiary
      • Get partner crypto wallet beneficiary
      • Remove partner crypto wallet beneficiary
      • Sync partner crypto wallet beneficiary
      • Create partner crypto withdrawal approval draft
      • List partner crypto withdrawals
      • Submit an approved partner crypto withdrawal for processing
      • Get partner crypto withdrawal
      • List partner crypto refunds
      • Create partner crypto refund approval draft
      • Get partner crypto refund
      • Submit an approved partner crypto refund for processing
      • Confirm partner crypto refund
      • List partner crypto checkouts
      • Create partner crypto checkout
      • Get partner crypto checkout
      • Create partner checkout link
      • Create partner checkout POS payment request
      • Close partner crypto checkout
      • List partner collection buyers
      • Create partner collection buyer
      • Get partner collection buyer
      • Update partner collection buyer
      • List partner collection wallets
      • Create partner collection wallet
      • Get partner collection wallet
      • Update partner collection wallet expiry
      • Deactivate partner collection wallet
      • List partner collection payments
      • Get partner collection payment
    • Schemas
      • CreatePartnerCustomerRequest
      • PartnerCustomerType
      • PartnerCustomerStatus
      • PartnerCustomer
      • LinkPartnerCustomerFileRequest
      • UploadPartnerCustomerFileRequest
      • PartnerCustomerFile
      • PartnerOnboardingSubmissionRequest
      • PartnerOnboardingEvidenceSubmission
      • PartnerIndividualKycSubmission
      • PartnerKycPersonalDetails
      • PartnerKycAdditionalPersonalDetails
      • PartnerCorporateKybSubmission
      • PartnerKybCorporationDetails
      • PartnerKybAdditionalCorporationDetails
      • PartnerOnboardingSupportingDocument
      • PartnerOnboardingAddress
      • PartnerOnboardingContactNumber
      • PartnerOnboardingContactPerson
      • PartnerOnboardingKeyPerson
      • PartnerOnboardingSubmission
      • PartnerBalancePage
      • PartnerBalance
      • PartnerTransactionPage
      • PartnerTransaction
      • CreatePartnerFiatAccountApplicationRequest
      • SubmitPartnerFiatAccountAdditionalInfoRequest
      • PartnerFiatCapabilities
      • PartnerFiatCapabilitiesData
      • PartnerFiatCapabilityRoute
      • PartnerFiatAccountApplication
      • PartnerFiatAccountPage
      • PartnerFiatAccount
      • PartnerFiatAccountBankDetails
      • PartnerFiatDepositInstructions
      • PartnerFiatDepositInstruction
      • PartnerFiatDepositPage
      • PartnerFiatDeposit
      • PartnerCryptoDepositWalletPage
      • PartnerCryptoDepositWallet
      • PartnerCryptoDepositPage
      • PartnerCryptoDeposit
      • SubmitPartnerCryptoTravelRuleInfoRequest
      • PartnerCryptoTravelRuleInfo
      • CreatePartnerCryptoWithdrawalQuoteRequest
      • PartnerCryptoWithdrawalQuote
      • CreatePartnerWalletBeneficiaryRequest
      • PartnerWalletBeneficiarySupportFile
      • PartnerCryptoWalletBeneficiaryActionRequest
      • PartnerWalletBeneficiaryPage
      • PartnerWalletBeneficiary
      • CreatePartnerCryptoWithdrawalRequest
      • SubmitPartnerCryptoWithdrawalRequest
      • PartnerCryptoWithdrawalPage
      • PartnerCryptoWithdrawal
      • CreatePartnerCryptoRefundRequest
      • SubmitPartnerCryptoRefundRequest
      • PartnerCryptoRefundPage
      • PartnerCryptoRefund
      • CreatePartnerConversionQuoteRequest
      • CreatePartnerConversionRequest
      • PartnerConversionQuotePage
      • PartnerConversionQuote
      • PartnerConversionPage
      • PartnerConversion
      • CreatePartnerCheckoutRequest
      • PartnerCheckoutPage
      • PartnerCheckout
      • CreatePartnerCheckoutLinkRequest
      • PartnerCheckoutLink
      • CreatePartnerCheckoutPosPaymentRequest
      • PartnerCheckoutPosPaymentRequest
      • PartnerCheckoutActionRequest
      • CreatePartnerBuyerRequest
      • UpdatePartnerBuyerRequest
      • PartnerBuyerDocument
      • PartnerBuyerPage
      • PartnerBuyer
      • CreatePartnerCollectionWalletRequest
      • UpdatePartnerCollectionWalletExpiryRequest
      • PartnerCollectionWalletActionRequest
      • PartnerCollectionWalletPage
      • PartnerCollectionWallet
      • PartnerCollectionWalletAddress
      • PartnerCollectionPaymentPage
      • PartnerCollectionPayment
      • CreatePartnerBankAccountRequest
      • PartnerBankAccountThirdPartyBeneficiary
      • PartnerBankAccountThirdPartyAddress
      • PartnerBankAccountPage
      • PartnerBankAccount
      • PartnerFiatWithdrawalCapabilities
      • PartnerFiatWithdrawalCapabilitiesData
      • PartnerFiatWithdrawalCapabilityRoute
      • ActivatePartnerFiatWithdrawalCapabilityRequest
      • SubmitPartnerFiatWithdrawalCapabilityAdditionalInfoRequest
      • PartnerFiatWithdrawalCapabilityActivation
      • CreatePartnerFiatWithdrawalQuoteRequest
      • PartnerFiatWithdrawalQuote
      • PartnerBalanceAvailability
      • CreatePartnerFiatWithdrawalRequest
      • SubmitPartnerFiatWithdrawalRequest
      • SubmitPartnerFiatWithdrawalAdditionalInfoRequest
      • PartnerFiatWithdrawalAdditionalInfo
      • PartnerFiatWithdrawalPage
      • PartnerFiatWithdrawal
      • PartnerOperationAuthorizationEvidence
      • PageInfo
      • PartnerProblem
      • PartnerProblemCode

    Product Workflows

    The Partner API exposes partner-safe product workflows under /partner/v1.
    Each endpoint still enforces the Partner API client scopes, enabled products,
    customer ownership, resource ownership, and product state rules configured by
    Oceafin.

    Cross-Product Reads#

    Use these after customer onboarding and product activity exists:
    MethodPathPurpose
    GET/partner/v1/customers/{customerId}/balancesList customer balances.
    GET/partner/v1/customers/{customerId}/transactionsList customer transactions.
    GET/partner/v1/transactions/{transactionId}Get transaction detail.

    Fiat Account And Deposits#

    Recommended flow:
    1.
    Query account capabilities.
    2.
    Create an account application.
    3.
    Submit additional information if required.
    4.
    List fiat accounts.
    5.
    Retrieve deposit instructions.
    6.
    Read deposit list/detail.
    MethodPathPurpose
    GET/partner/v1/customers/{customerId}/fiat-account-capabilitiesGet fiat account capabilities.
    POST/partner/v1/customers/{customerId}/fiat-account-applicationsCreate fiat account application.
    POST/partner/v1/fiat-account-applications/{applicationId}/additional-infoSubmit account application additional information.
    GET/partner/v1/customers/{customerId}/fiat-accountsList fiat accounts.
    GET/partner/v1/customers/{customerId}/fiat-deposit-instructionsGet fiat deposit instructions.
    GET/partner/v1/customers/{customerId}/fiat-depositsList fiat deposits.
    GET/partner/v1/fiat-deposits/{depositId}Get fiat deposit detail.

    Fiat Withdrawals#

    Recommended flow:
    1.
    Create or list bank accounts.
    2.
    Query and activate withdrawal capability.
    3.
    Create a withdrawal quote.
    4.
    Create a withdrawal approval draft with operation authorization evidence.
    5.
    Submit the approved withdrawal.
    6.
    Submit additional information if required.
    7.
    Read withdrawal list/detail.
    MethodPathPurpose
    GET/partner/v1/customers/{customerId}/bank-accountsList bank accounts.
    POST/partner/v1/customers/{customerId}/bank-accountsCreate bank account.
    GET/partner/v1/customers/{customerId}/fiat-withdrawal-capabilitiesGet withdrawal capabilities.
    POST/partner/v1/customers/{customerId}/fiat-withdrawal-capabilities/activationActivate withdrawal capability.
    POST/partner/v1/fiat-withdrawal-capability-activations/{activationId}/additional-infoSubmit capability activation additional information.
    POST/partner/v1/customers/{customerId}/fiat-withdrawal-quotesCreate withdrawal quote.
    POST/partner/v1/customers/{customerId}/fiat-withdrawalsCreate withdrawal approval draft.
    POST/partner/v1/fiat-withdrawals/{withdrawalId}/submissionSubmit approved withdrawal.
    POST/partner/v1/fiat-withdrawals/{withdrawalId}/additional-infoSubmit withdrawal additional information.
    GET/partner/v1/customers/{customerId}/fiat-withdrawalsList withdrawals.
    GET/partner/v1/fiat-withdrawals/{withdrawalId}Get withdrawal detail.

    Crypto Deposits#

    MethodPathPurpose
    GET/partner/v1/customers/{customerId}/crypto/deposit-walletsList deposit wallets.
    GET/partner/v1/customers/{customerId}/crypto/depositsList crypto deposits.
    GET/partner/v1/crypto/deposits/{depositId}Get crypto deposit detail.
    POST/partner/v1/crypto/deposits/{depositId}/travel-rule-infoSubmit Travel Rule information.

    Crypto Withdrawals#

    MethodPathPurpose
    POST/partner/v1/customers/{customerId}/crypto-withdrawal-quotesCreate withdrawal quote.
    GET/partner/v1/customers/{customerId}/crypto/wallet-beneficiariesList wallet beneficiaries.
    POST/partner/v1/customers/{customerId}/crypto/wallet-beneficiariesCreate wallet beneficiary.
    GET/partner/v1/crypto/wallet-beneficiaries/{walletBeneficiaryId}Get wallet beneficiary detail.
    POST/partner/v1/crypto/wallet-beneficiaries/{walletBeneficiaryId}/removalRemove wallet beneficiary.
    POST/partner/v1/crypto/wallet-beneficiaries/{walletBeneficiaryId}/syncSync wallet beneficiary status.
    POST/partner/v1/customers/{customerId}/crypto-withdrawalsCreate withdrawal approval draft.
    POST/partner/v1/crypto-withdrawals/{withdrawalId}/submissionSubmit approved withdrawal.
    GET/partner/v1/customers/{customerId}/crypto-withdrawalsList withdrawals.
    GET/partner/v1/crypto-withdrawals/{withdrawalId}Get withdrawal detail.

    Crypto Checkouts#

    MethodPathPurpose
    GET/partner/v1/customers/{customerId}/crypto/checkoutsList checkouts.
    POST/partner/v1/customers/{customerId}/crypto/checkoutsCreate checkout.
    GET/partner/v1/crypto/checkouts/{checkoutId}Get checkout detail.
    POST/partner/v1/crypto/checkouts/{checkoutId}/linksCreate checkout link.
    POST/partner/v1/crypto/checkouts/{checkoutId}/pos-payment-requestsCreate POS payment request.
    POST/partner/v1/crypto/checkouts/{checkoutId}/closeClose checkout.

    Crypto Collection#

    MethodPathPurpose
    GET/partner/v1/customers/{customerId}/buyersList buyers.
    POST/partner/v1/customers/{customerId}/buyersCreate buyer.
    GET/partner/v1/buyers/{buyerId}Get buyer detail.
    POST/partner/v1/buyers/{buyerId}Update buyer.
    GET/partner/v1/customers/{customerId}/collection-walletsList collection wallets.
    POST/partner/v1/customers/{customerId}/collection-walletsCreate collection wallet.
    GET/partner/v1/collection-wallets/{walletId}Get collection wallet detail.
    POST/partner/v1/collection-wallets/{walletId}/expiryUpdate collection wallet expiry.
    POST/partner/v1/collection-wallets/{walletId}/deactivationDeactivate collection wallet.
    GET/partner/v1/customers/{customerId}/collection-paymentsList collection payments.
    GET/partner/v1/collection-payments/{paymentId}Get collection payment detail.

    Crypto Refunds#

    Refund flow:
    1.
    Create a refund approval draft.
    2.
    Submit the approved refund. Oceafin accepts the approved draft for refund
    processing and stores the processing reference.
    3.
    Confirm the submitted refund. Oceafin records the confirmation and stores the
    latest status.
    MethodPathPurpose
    GET/partner/v1/customers/{customerId}/crypto/refundsList refunds.
    POST/partner/v1/customers/{customerId}/crypto/refundsCreate refund approval draft.
    GET/partner/v1/crypto/refunds/{refundId}Get refund detail.
    POST/partner/v1/crypto/refunds/{refundId}/submissionSubmit approved refund.
    POST/partner/v1/crypto/refunds/{refundId}/confirmationConfirm submitted refund.

    Conversion#

    MethodPathPurpose
    GET/partner/v1/customers/{customerId}/conversion-quotesList conversion quotes.
    POST/partner/v1/customers/{customerId}/conversion-quotesCreate conversion quote.
    GET/partner/v1/conversion-quotes/{quoteId}Get conversion quote detail.
    GET/partner/v1/customers/{customerId}/conversionsList conversions.
    POST/partner/v1/customers/{customerId}/conversionsCreate conversion approval draft.
    GET/partner/v1/conversions/{conversionId}Get conversion detail.

    Operation Authorization Evidence#

    Money-out, refund, and conversion creation/submission calls require
    operationAuthorization.
    Required fields:
    operationType
    operationHash
    authorizedAt
    authorizationMethod
    sourceSystem
    sourceActionRef
    rawEvidence
    The operationHash must match the immutable operation payload expected by
    Oceafin. Operation authorization records partner-side approval, but Oceafin still
    applies its own validation, limits, status rules, and product controls.
    Modified at 2026-06-28 01:20:16
    Previous
    Customers And Onboarding
    Next
    Webhooks
    Built with