Gateway API
  1. Payment Contract
Gateway API
  • Gateway
    • Payments
      • Payment Contract
        • Generate a Payment Contract
          POST
        • Get Payment Contract
          GET
        • Cancel a Payment Contract
          DELETE
      • Webhook receiver for payment events
        POST
    • Fund Transfers
      • Transfer Contracts
        • Generate a Transfer Contract
        • Update Transfer Contract
        • Issue the Transfer Contract
        • Get Transfer Contract
        • Pay a Transfer Contract
        • Cancel a Transfer Contract
        • Contract Event Webhook
    • Schemas
      • Response
  • Schemas
    • Schemas
      • Response
        • Accounts
          • ResetAPIKeysResponse
          • GetAccountResponse
          • GetAccountActivitiesResponse
        • Wallets
          • CreateWalletResponse
          • CreateDebitEntryResponse
        • Profiles
        • Gateway
          • Transfers
            • GetTransferContractResponse
          • Payments
            • GetPaymentContractResponse
        • SuccessResponse
        • ErrorResponse
      • Models
        • Activities
          • Activity Types
            • PaymentActivityModel
          • SubActivityModel
          • ActivityModel
        • Profiles
          • ProfileModel
          • PersonalProfileModel
          • VerifiedPersonalProfileModel
          • EconomicProfileModel
          • BusinessProfileModel
          • GeographicProfileModel
          • TransactionRecordsModel
          • BehavioralProfileModel
          • DocumentaryProfileModel
          • RiskProfileModel
          • NetworkProfileModel
          • IndustryProfileModel
        • Accounts
          • APIKeysModel
          • AccountModel
          • AccountProxyModel
        • Wallets
          • WalletModel
          • WalletKeysModel
          • LedgerEntryModel
          • TransactionPayloadModel
        • Command
          • Parameters
            • TransferAmountParameters
          • CommandModel
          • CommandContextModel
          • CommandSignerModel
        • Policies
          • Service Policies
            • Accounts Policy
              • Constraints
              • Roles
              • AccountsPolicyModel
          • Policy Templates
            • ServicePolicyModel
            • ServiceRoleModel
            • ServiceConstraintModel
        • Verifiers
          • VerifierModel
          • VerificationModel
        • JWTs
          • ContractToken
        • Resources
        • Gateway
          • Transfers
            • TransferContractModel
            • TransferChannelModel
            • TransferRecipientModel
          • Payments
            • PaymentContractModel
            • PaymentChannelModel
            • PaymentRecipientModel
          • Contracts
            • ContractConstraintModel
            • ContractPreviewModel
            • ContractPaymentModel
            • ContractRecipientModel
            • ChannelModel
            • ContractDeliverableModel
          • Events
            • WebhookEvent
          • Channels
            • ChannelFeesModel
            • ChannelPolicyModel
          • ContractModel
      • RequestBodies
        • Commands
          • ExecuteCommandPayload
        • Accounts
          • CreateAccountPayload
          • RegisterAccountDevicePayload
          • RegisterAccountRecoveryMethodPayload
          • AccountPersonalProfilePayload
          • AttachAccountProfilePayload
        • Wallets
          • CreateWalletPayload
          • CreateDebitEntryPayload
          • DeleteWalletPayload
        • Verifier
          • StartVerificationPayload
          • CompleteVerificationPayload
        • Policies
          • AttachPolicyPayload
        • Resources
          • RegisterResourcePayload
          • RegisterResourceVerifiersPayload
        • Profiles
          • RequestProfileAccessTokenPayload
        • Gateway
          • Transfers
            • GenerateTransferContractPayload
            • UpdateTransferContractPayload
          • Payments
            • GeneratePaymentContractPayload
            • CryptoPaymentPayload
            • MayaPaymentPayload
            • GCashPaymentPayload
            • WalletPaymentPayload
            • QRPHPaymentPayload
            • CardPaymentPayload
  1. Payment Contract

Generate a Payment Contract

Designing
POST
/contracts/payment
Generate a payment quote for an account. The API Key contains information about the account and will automatically figure out the wallet address to which the payment will be sent.

Request

Authorization
API Key
Add parameter in header
X-Api-Key
Example:
X-Api-Key: ********************
or
Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/contracts/payment' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 100050,
    "currency": "USD",
    "description": "Passport renewal",
    "deliverable": {
        "type": "order",
        "reference_id": "bErIVpfG1rRYxAmzDaB-3",
        "description": "Passport renewal"
    },
    "channel": "qrph",
    "expires_in": 3600
}'
Response Response Example
{
    "status": 200,
    "message": "Conculco utor correptius crinis aperiam fugiat aduro quasi.",
    "data": {
        "contract": {
            "id": "0d34291d-a788-4b65-8413-2e00f156e471",
            "amount": 79200,
            "currency": "PHP",
            "status": "issued",
            "issued_by": "d17752d7-3998-48bb-9cbc-5d7224e4b42b",
            "issued_at": "2025-09-19T01:46:09.619Z",
            "expires_at": "2025-09-19T01:46:09.623Z",
            "description": "The beautiful range of Apple Naturalé that has an exciting mix of natural ingredients. With the Good",
            "deliverable": {
                "type": "remittance",
                "reference_id": "9rOpnKdqXg_CM9UYgwRQG",
                "description": "The Football Is Good For Training And Recreational Purposes",
                "details": "dolore id cillum occaecat nulla"
            },
            "recipient": {
                "name": "Makati Branch",
                "wallet": "0x3c092afadaf8d1adbea9cb5cfc2df65ab6ea4d83"
            },
            "channel": {
                "id": "qrph",
                "service": "qrph",
                "name": "QRPH",
                "description": "Pay using QRPH",
                "fees": {
                    "covered": true
                }
            },
            "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJlYzRlNTYzMC1mMTc4LTQ0ZDMtODk5My01YzIwZmIxZTI1YTgiLCJhY2MiOiIyNDgwYTZlOC1kOTI0LTQ5ZWUtODcyNy05Njk4Mjk1ODA1ZjkiLCJpYXQiOjE3NTgyNDYzNjksImV4cCI6MTc1ODI0NjM2OSwiYW10Ijo5NDgsImNjeSI6IkVUSCJ9.1K_DaCs0HOMnPAqAQkR06aj9lT4Cq0JT_HIS7Sb_F1k"
        },
        "qrph": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAeoAAAHqAQAAAADjFjCXAAAEJ0lEQVR4nO2dS46jSBCGvxiQvARpDuCjwA3mSKU+Ut8AjuIDjJQsLWFFL/KF3TtDy+X2H4sSYD4BUijemWXODpn/2UODcOHChQsXLly48GNxS9LCbGawtJhZi42LGSz52rjkW8fjni7803Dc3Z3B3d1Dk/+U0ynesvLwaySmt/524a/Gl2K+uBmzteloCGDjcoqpro0QjeCxTxf+4fh8dofuamZ948znFebzNeqkT3/46cI/Ex/CzWA5+VbD4umtmMM/9nThH4FnX9k5sIBB4zaE3nxwMDpgmG4GnWMA27ryW3+78Bfjs5mZ9cAQAGjcxqWF4XJyWE7OcEmxnpmZHfp04R+GR1tXzZfD1aC7ms99g8895iw38/l8Nb+3dK9+eeFvipfKyYpPNM4QKEeNA4371K0xkYhHVVQ5Ef6UJPXpiiaFrFwTpUAXqsKtbG6W1gl/SpL60ETXmcycr0Dn0fRF++chWUKgkdYJ343blyfPaV8BfMqlknxb4zbG02ZTL/4eLy/87fAcpeV2F0Wvah+MFNx5/iHI1gnfj5udr2Zjd7Ucua3YSBO7FNmvJltn1svWCd8lNYdIMZy7Q7duArnfjaCyCeG7pHrYqGtTtwKlhlKS1judlNYJ3yVZgdZNW4JapdsUTUJRwpjmSuuEPyuxSkwuxuV6yda51qJdmsPLCa+0TvgOPM6XzNbi09LC3AMxczivOdfIcR1zr2xC+B5pN8eDQxw3gVvqw7IYTmy/Xs1ZeqA76unCPxm3r8vJ0xoJwKpdo1sx628WB4rn8wpDHm3/Hi8v/O3wHNfl9GGTUsQ5gLuObJ4SQHGd8D2S+7BArchN1Cod5OTibqGOtE7481JLvsmQdfko6lUu1aVb6goyaZ3wnfhsLf7DTg6LmU95PWw8/dGTF8pGuWk9rPA9srFhNa6LLQjuOhcx4OtKSVm2TvjTkuO60mktHTHKQHFxuMomhB+Bb7QuzghPpMbXZg4gDjlt2hfqTQg/Au9WGC4lcltShAfLKU16emjczNq7pdjf4+WFvxleUtWV7EhLHTiv0UkGD3IfNqC4Tvge2ZTgpnil1kZKchHq4EmT3LE8rPDnZZulFjNXtS4pYW5QTLBJc6V1wp+TXDnJy8PqtTrkOYSa3IKyCeHH9SbufG1ZhZ1Vr/667Vy89bcLfxVeuv9A9KYB7npjOeAr/lcT7MIPzCYeVyHmcRNKcJdsXVCVWPgReN6rM63WWczqujH3kGfuSjPWxiOfLvyz8Pbh3IZLu1raui44839piyfm/v+W4WePw5qxt/524a/CNznsb7VhtvN1ydd2xc3Kwwp/Vh736kw7JIY+Xo5qN5+v5kP4F4cbPvchb2P31t8u/FX4Yw4bE9S4V1iom52U27taOZatE/6kmP57nXDhwoULFy5c+F+B/wKYwUlImlIFVQAAAABJRU5ErkJggg==
",
        "checkout_url": "https://payments.pisomind.ph/checkout?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJlYzRlNTYzMC1mMTc4LTQ0ZDMtODk5My01YzIwZmIxZTI1YTgiLCJhY2MiOiIyNDgwYTZlOC1kOTI0LTQ5ZWUtODcyNy05Njk4Mjk1ODA1ZjkiLCJpYXQiOjE3NTgyNDYzNjksImV4cCI6MTc1ODI0NjM2OSwiYW10Ijo5NDgsImNjeSI6IkVUSCJ9.1K_DaCs0HOMnPAqAQkR06aj9lT4Cq0JT_HIS7Sb_F1k"
    }
}
Modified at 2025-10-24 03:20:16
Next
Get Payment Contract
Built with