Oracle Accounts

The Oracle Accounts endpoints manage the Oracle billing account records associated with Verifone customers. These accounts link order and provisioning data to Oracle for invoicing and financial processing.

Oracle account operations are typically performed by Verifone back-office processes. Confirm access requirements with your Verifone integration contact before using these endpoints.

API Reference

Search Oracle Accounts

Get the list of all oracle accounts

get

By passing in the appropriate options, you can search for available Oracle accounts in the system.

Query parameters

oracleAccountIdintegerOptional

Oracle Account Id.

Example: 12031585

userUidstring · uuidOptional

The User ID corresponding to the User who created or modified the order.

Example: 04f5ea24-cc4f-11e8-a8d5-f2801f1b9fd1

merchantCompanyEntityUidstring · uuidOptional

The Verifone allocated unique ID for this merchant company.

Example: 14f5ea24-cc4f-11e8-a8d5-f2801f1b9fd9

Responses

200

search results matching criteria

application/json

400

Bad Request

application/json

401

Unauthorised Request

application/json

403

Forbidden Request.

application/json

404

Not Found Request

application/json

429

Too Many Requests

application/json

500

Internal Error

application/json

503

Service Not Available

application/json

504

Service Timeout

application/json

get

/accounts/oracle

HTTPcURLJavaScriptPython

GET /accounts/oracle HTTP/1.1
Host: api.verifone.com
Accept: */*

{
  "accounts": []
}

Add Oracle Account

Add Oracle account

post

Add Oracle account with MOP users and/or merchant company

Body

application/json

oracleAccountIdintegerRequired

Oracle Account Id.

Example: 12031585

userUidstring · uuidOptional

The assigned User ID corresponding to the Order Created By.

Example: 04f5ea24-cc4f-11e8-a8d5-f2801f1b9fd1

merchantCompanyEntityUidstring · uuidOptional

The Verifone allocated unique ID for this merchant company.

Example: 14f5ea24-cc4f-11e8-a8d5-f2801f1b9fd9

Responses

201

Add Oracle Account Success.

No content

400

Bad Request

application/json

401

Unauthorised Request

application/json

403

Forbidden Request.

application/json

404

Not Found Request

application/json

429

Too Many Requests

application/json

500

Internal Error

application/json

503

Service Not Available

application/json

504

Service Timeout

application/json

post

/accounts/oracle

HTTPcURLJavaScriptPython

POST /accounts/oracle HTTP/1.1
Host: api.verifone.com
Content-Type: application/json
Accept: */*
Content-Length: 143

{
  "oracleAccountId": 12031585,
  "userUid": "04f5ea24-cc4f-11e8-a8d5-f2801f1b9fd1",
  "merchantCompanyEntityUid": "14f5ea24-cc4f-11e8-a8d5-f2801f1b9fd9"
}

No content

Update Oracle Account

This is a PATCH operation — only the fields provided in the request body will be updated.

Update Oracle account

patch

Update Oracle account with MOP users and/or merchant company.

Path parameters

oracleAccountIdintegerRequired

Oracle Account Id.

Example: 12031585

Body

application/json

oracleAccountIdintegerRequired

Oracle Account Id.

Example: 12031585

userUidstring · uuidOptional

The assigned User ID corresponding to the Order Created By.

Example: 04f5ea24-cc4f-11e8-a8d5-f2801f1b9fd1

merchantCompanyEntityUidstring · uuidOptional

The Verifone allocated unique ID for this merchant company.

Example: 14f5ea24-cc4f-11e8-a8d5-f2801f1b9fd9

Responses

204

Patch Oracle Account Success.

400

Bad Request

application/json

401

Unauthorised Request

application/json

403

Forbidden Request.

application/json

404

Not Found Request

application/json

429

Too Many Requests

application/json

500

Internal Error

application/json

503

Service Not Available

application/json

504

Service Timeout

application/json

patch

/accounts/oracle/{oracleAccountId}

HTTPcURLJavaScriptPython

PATCH /accounts/oracle/{oracleAccountId} HTTP/1.1
Host: api.verifone.com
Content-Type: application/json
Accept: */*
Content-Length: 143

{
  "oracleAccountId": 12031585,
  "userUid": "04f5ea24-cc4f-11e8-a8d5-f2801f1b9fd1",
  "merchantCompanyEntityUid": "14f5ea24-cc4f-11e8-a8d5-f2801f1b9fd9"
}

No content

Delete Oracle Account

Deleting an Oracle account is irreversible and may affect billing and invoicing for associated customers. Verify downstream dependencies before proceeding.

Delete Oracle account

delete

Delete Oracle account with MOP users and/or merchant company.

Path parameters

oracleAccountIdintegerRequired

Oracle Account Id.

Example: 12031585

Responses

204

The Oracle accounts for user was successfully deleted.

400

Bad Request

application/json

401

Unauthorised Request

application/json

403

Forbidden Request.

application/json

404

Not Found Request

application/json

429

Too Many Requests

application/json

500

Internal Error

application/json

503

Service Not Available

application/json

504

Service Timeout

application/json

delete

/accounts/oracle/{oracleAccountId}

HTTPcURLJavaScriptPython

DELETE /accounts/oracle/{oracleAccountId} HTTP/1.1
Host: api.verifone.com
Accept: */*

No content