Request money (atomic flow)

curl --request POST \
  --url https://raas-partner-cv.nomas.cash/v1/user/operations/request-money-full \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "requester": {
    "lastName": "<string>",
    "firstName": "<string>",
    "address1": "<string>",
    "countryCode": "<string>",
    "city": "<string>",
    "state": "<string>",
    "phoneNumber": "<string>",
    "lastName2": "<string>",
    "dob": "2023-11-07T05:31:56Z",
    "email": "<string>",
    "middleName": "<string>",
    "address2": "<string>",
    "address3": "<string>",
    "streetNumber": "<string>",
    "zipCode": "<string>",
    "birthState": "<string>",
    "placeDetail": "<string>",
    "latitude": 123,
    "longitude": 123,
    "callLocationLatitude": 123,
    "callLocationLongitude": 123
  },
  "request": {
    "recipientCurrency": "<string>",
    "recipientAmount": 123,
    "destinationPaymentMethod": {
      "currency": "<string>",
      "number": "<string>",
      "type": "DebitCard",
      "nameOnCard": "<string>",
      "expirationDate": "<string>",
      "country": "<string>",
      "accountNumber": "<string>",
      "bankEntityNumber": "<string>",
      "bankName": "<string>",
      "isPrimary": true,
      "name": "<string>",
      "id": "<string>",
      "cardType": "DebitCard"
    },
    "correlationId": "<string>",
    "requestTo": {
      "phoneNumber": "<string>",
      "firstName": "<string>",
      "lastName": "<string>",
      "countryCode": "<string>",
      "email": "<string>"
    },
    "reason": "<string>"
  }
}
'

{
  "userId": "<string>",
  "operationId": "<string>",
  "status": "Accepted",
  "link": "<string>"
}

Operations

Request money (atomic flow)

Request money (atomic / full): validates input, ensures a trusted requester (UserServices.ensureTrustedUser), then enqueues the RequestMoneyFull queue job (worker: CIP → contact → payment method → requestMoneyV2).

HTTP responds immediately with RequestMoneyFullResponse (status: "Accepted", operationId = correlationId, tenant attribution link). Synchronous 4xx/5xx: tenant/country, corridor, currency alignment, correlation id uniqueness, name/DOB/phone, and basic payout-method rules.

Webhook (operationStatusHook + sharedSecret): async outcome as RequestMoneyFullOutcomePayload (eventType: "request_money_full_outcome"; status "Accepted" or "Failed" with errorCode, reason, phase). Header x-raas-signature = Base64(HMAC-SHA256(raw JSON body, tenant sharedSecret)).

See also: Webhooks reference.

POST

user

operations

request-money-full

Request money (atomic flow)

curl --request POST \
  --url https://raas-partner-cv.nomas.cash/v1/user/operations/request-money-full \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "requester": {
    "lastName": "<string>",
    "firstName": "<string>",
    "address1": "<string>",
    "countryCode": "<string>",
    "city": "<string>",
    "state": "<string>",
    "phoneNumber": "<string>",
    "lastName2": "<string>",
    "dob": "2023-11-07T05:31:56Z",
    "email": "<string>",
    "middleName": "<string>",
    "address2": "<string>",
    "address3": "<string>",
    "streetNumber": "<string>",
    "zipCode": "<string>",
    "birthState": "<string>",
    "placeDetail": "<string>",
    "latitude": 123,
    "longitude": 123,
    "callLocationLatitude": 123,
    "callLocationLongitude": 123
  },
  "request": {
    "recipientCurrency": "<string>",
    "recipientAmount": 123,
    "destinationPaymentMethod": {
      "currency": "<string>",
      "number": "<string>",
      "type": "DebitCard",
      "nameOnCard": "<string>",
      "expirationDate": "<string>",
      "country": "<string>",
      "accountNumber": "<string>",
      "bankEntityNumber": "<string>",
      "bankName": "<string>",
      "isPrimary": true,
      "name": "<string>",
      "id": "<string>",
      "cardType": "DebitCard"
    },
    "correlationId": "<string>",
    "requestTo": {
      "phoneNumber": "<string>",
      "firstName": "<string>",
      "lastName": "<string>",
      "countryCode": "<string>",
      "email": "<string>"
    },
    "reason": "<string>"
  }
}
'

{
  "userId": "<string>",
  "operationId": "<string>",
  "status": "Accepted",
  "link": "<string>"
}

Authorizations

api_key

string

header

required

Body

application/json

RequestMoneyFullParams body

POST /request-money-full body: register-or-link the requester, then async money request to requestTo with destinationPaymentMethod (see RaaSPartnerPaymentMethod).

Controller validates partner vs requester.countryCode, phone prefix, names, DOB, amounts/currency vs partner country, corridor (DestinationCountry / DestinationPaymentMethodType from destination PM), and idempotent correlationId.

requester

object

required

End-user profile and address. Same shape as partner registration; becomes the trusted sender after ensureTrustedUser. Field-level docs: RegisterUserParams (model/partner/auth).

Show child attributes

request

object

required

Correlation id, beneficiary, amounts, optional reason, and payout method. Processed asynchronously after HTTP 200.

Show child attributes

Response

Immediate HTTP 200 payload after the job is enqueued (not final operation state). Final async outcome is delivered only via RequestMoneyFullOutcomePayload webhook when configured.

userId

string

required

Trusted user id created or resolved during the call.

operationId

string

required

Same value as request.correlationId.

status

enum<string>

required

Always "Accepted" here meaning “accepted for processing”, not platform operation completed.

Available options:

Accepted

link

string

required

Tenant attribution / tracking URL for this correlation id.

Request money Get operation status