Skip to main content
Use these endpoints for in-app OLIVE payments. They support custom metadata and return that metadata after a successful payment.
Payment routes use HMAC headers, not bearer tokens: X-API-Key-ID, X-Timestamp, and X-Signature.

​
Endpoints

Process Payment

POST /api/v1/paymentProcess an in-app OLIVE payment and attach arbitrary metadata

Verify Card

POST /api/v1/payment/verify-cardSame behavior as the POS verify-card endpoint

Refund

POST /api/v1/payment/refundSame behavior as the POS refund endpoint

Lookup Card

POST /api/v1/payment/lookup-cardSame behavior as the POS lookup-card endpoint

​
Notes

  • POST /api/v1/payment is for in-app payments, not POS terminal payments.
  • terminal_id is not used on this route.
  • Custom metadata can be any valid JSON object, array, string, number, boolean, or null and is echoed back in the success response.
  • POST /api/v1/payment/verify-account is also available and mirrors the POS account verification route.